# Neo4j GDS Agent (MCP server)

> Neo4j GDS Agent is an MCP server that adds database tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Neo4j Graph Data Science MCP server. It has 98 GitHub stars, is released under the MIT license and runs locally with uvx gds-agent.

The GDS Agent let LLMs reason and do data science work on your graph data in Neo4j, by using two artifacts: It works with any MCP-capable harness — Claude Code, Claude Desktop, claude.ai, OpenAI Codex, Cursor, VS Code/Copilot, Gemini CLI — and programmatically from agent frameworks. It uses the GDS plugin on self-managed Neo4j and GDS Aura Graph Analytics sessions on AuraDB, over STDIO or HTTP transport.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/neo4j-contrib/gds-agent |
| GitHub stars | 98 |
| License | MIT |
| Language | Python |
| Transport | stdio |
| Packages | pypi: gds-agent |
| Remote URL | none |
| Needs API key | yes |
| Official | yes |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Databases |
| Latest release | v1.0.1 (Jul 13, 2026) |
| Last commit | Sep 21, 2026 |
| MCP registry name | io.github.neo4j-contrib/gds-agent |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "neo4j-gds-agent": {
      "command": "uvx",
      "args": [
        "gds-agent"
      ],
      "env": {
        "NEO4J_URI": "your-value",
        "NEO4J_USERNAME": "your-value",
        "NEO4J_PASSWORD": "your-value",
        "AURA_API_CLIENT_SECRET": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env NEO4J_URI=your-value --env NEO4J_USERNAME=your-value --env NEO4J_PASSWORD=your-value --env AURA_API_CLIENT_SECRET=your-value --transport stdio neo4j-gds-agent -- uvx gds-agent
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "neo4j-gds-agent": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "gds-agent"
      ],
      "env": {
        "NEO4J_URI": "your-value",
        "NEO4J_USERNAME": "your-value",
        "NEO4J_PASSWORD": "your-value",
        "AURA_API_CLIENT_SECRET": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "neo4j_password",
      "description": "NEO4J_PASSWORD",
      "password": true
    },
    {
      "type": "promptString",
      "id": "aura_api_client_secret",
      "description": "AURA_API_CLIENT_SECRET",
      "password": true
    }
  ],
  "servers": {
    "neo4j-gds-agent": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "gds-agent"
      ],
      "env": {
        "NEO4J_URI": "your-value",
        "NEO4J_USERNAME": "your-value",
        "NEO4J_PASSWORD": "${input:neo4j_password}",
        "AURA_API_CLIENT_SECRET": "${input:aura_api_client_secret}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `NEO4J_URI` (required): Neo4j connection URI (neo4j:// or neo4j+s://)
- `NEO4J_USERNAME` (required): Neo4j username
- `NEO4J_PASSWORD` (secret) (required): Neo4j password
- `NEO4J_DATABASE`: Neo4j database name
- `AURA_API_CLIENT_ID`: Aura API client ID (enables Aura Graph Analytics session mode)
- `AURA_API_CLIENT_SECRET` (secret): Aura API client secret
- `AURA_API_PROJECT_ID`: Aura project ID (only if the API client can access multiple projects)

## Similar MCP servers

- [Dbx](https://appsgit.com/mcp-servers/dbx): Query databases from AI agents using connections configured in DBX. (24,945 stars, Apache-2.0)
- [Butterbase AI MCP Server](https://appsgit.com/mcp-servers/butterbase-ai-mcp-server): Butterbase MCP server — manage your backend: schemas, auth, functions, storage, RAG, deploys. (3,686 stars, Apache-2.0, needs API key)
- [DBHub](https://appsgit.com/mcp-servers/dbhub): Token-efficient database MCP server for PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SQLite. (3,610 stars, MIT, needs API key)
- [LINQ to DB](https://appsgit.com/mcp-servers/linq-to-db): Inspect database schemas and execute SQL queries across multiple database providers with LINQ to DB. (3,332 stars, MIT)
- [Mindwtr](https://appsgit.com/mcp-servers/mindwtr): Task automation via SQLite, desktop Local API, or Mindwtr Cloud; read-only by default. (2,211 stars, AGPL-3.0, needs API key)
- [MCP Memory Service](https://appsgit.com/mcp-servers/mcp-memory-service): Open-source persistent memory for AI agent pipelines (LangGraph, CrewAI, AutoGen) and Claude. (1,988 stars, Apache-2.0)

---

Canonical page: https://appsgit.com/mcp-servers/neo4j-gds-agent
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.