Neo4j GDS Agent MCP Server

The GDS Agent let LLMs reason and do data science work on your graph data in Neo4j, by using two artifacts. It runs locally over stdio via the published package.

People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-08-19 · ★ 96 · #108 OF 848 MAINTAINED OTHER · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install Neo4j GDS Agent

before you install - you'll need

Set NEO4J_URI, NEO4J_USERNAME, NEO4J_PASSWORD, NEO4J_READ_ONLY, NEO4J_RESPONSE_TOKEN_LIMIT before connecting.

Claude Code

claude mcp add neo4j-contrib-gds-agent -- uvx gds-agent

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "neo4j-contrib-gds-agent": {
      "command": "uvx",
      "args": [
        "gds-agent"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package gds-agent - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.neo4j-contrib is GitHub-verified and matches the repo owner

03 · What Neo4j GDS Agent can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v1.0.1 · 2026-07-13

Changelog - [1.0.1] - 2026-07-13 · 1. Add the mcp-name ownership marker to the PyPI package README so MCP Registry publishing passes ownership validation. · 2. Shorten the server.json description to the MCP registry…

0.5.1 · 2025-10-27

Changelog - [0.5.1] - 2025-10-27 · New Features · 1. Fix 0.5.1 version in pyproject.toml · Other Changes

0.5.0 · 2025-10-27

Changelog - [0.5.0] - 2025-10-27 · New Features · 1. Support projecting specific relationship types for heterogeneous graphs. · 1. Fix a bug where get_relationship_properties, get_node_properties, and get_node_labels…

04 · Who maintains Neo4j GDS Agent

Neo4j GDS Agent is maintained by neo4j-contrib. We track 5 MCP servers from neo4j-contrib - 5 actively maintained, 1,075 combined GitHub stars, oldest repo from Dec 2024. Full record: all servers from neo4j-contrib.

05 · Facts

repository: github.com/neo4j-contrib/gds-agent
category: other - ranked #108 of 848 actively-maintained other servers as of 2026-08-25.
release cadence: 1 release in the last 90 days (latest 2026-07-13)
registry: io.github.neo4j-contrib/gds-agent (active, first published 2026-07-13)
packages: pypi:gds-agent

06 · Neo4j GDS Agent FAQ

What is Neo4j GDS Agent?

The GDS Agent let LLMs reason and do data science work on your graph data in Neo4j, by using two artifacts. It runs locally over stdio via the published package.

Is Neo4j GDS Agent still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-19 and it shipped 1 release in the last 90 days. We re-verify nightly.

How do I install Neo4j GDS Agent?

Run `uvx gds-agent`. The README documents 5 environment variables (NEO4J_URI, NEO4J_USERNAME, NEO4J_PASSWORD…) to set first. Set NEO4J_URI, NEO4J_USERNAME, NEO4J_PASSWORD, NEO4J_READ_ONLY, NEO4J_RESPONSE_TOKEN_LIMIT before connecting. You can also paste the ready-made client config above.

Does Neo4j GDS Agent run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Neo4j GDS Agent

Alternatives to Neo4j GDS Agent

Maintained other servers if Neo4j GDS Agent isn't the fit.

More MCP servers to compare · Neo4j Data Modeling · Heor Agent · Swissgroceries MCP · Opentargets · Agentic Ads

More Python MCP servers · Neo4j Aura Manager · Neo4j Cypher · Neo4j Memory · Neo - AI/ML Engineering · see all