Neo4j GDS Agent
CommunityMCP server by neo4j-contrib · updated · ★ 98
Neo4j Graph Data Science MCP server Neo4j GDS Agent is a community project by neo4j-contrib, not verified by a company domain.
Last commit 10 days ago
MIT: permissive, fine for commercial use
Published package or server URL, 98 stars, original repository
Not checked yet. What we check
What you need
| Setting | Needed | What it is |
|---|---|---|
NEO4J_URIEnvironment variable | Required | Neo4j connection URI (neo4j:// or neo4j+s://) |
NEO4J_USERNAMEEnvironment variable | Required | Neo4j username |
NEO4J_PASSWORDEnvironment variable, secret | Required | Neo4j password |
NEO4J_DATABASEEnvironment variable | Optional | Neo4j database name |
AURA_API_CLIENT_IDEnvironment variable | Optional | Aura API client ID (enables Aura Graph Analytics session mode) |
AURA_API_CLIENT_SECRETEnvironment variable, secret | Optional | Aura API client secret |
AURA_API_PROJECT_IDEnvironment variable | Optional | Aura project ID (only if the API client can access multiple projects) |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install Neo4j GDS Agent
Built from the published package, never by AIclaude mcp add neo4j-gds-agent -e NEO4J_URI=YOUR_NEO4J_URI -e NEO4J_USERNAME=YOUR_NEO4J_USERNAME -e NEO4J_PASSWORD=YOUR_NEO4J_PASSWORD -- uvx gds-agentRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"neo4j-gds-agent": {
"command": "uvx",
"args": [
"gds-agent"
],
"env": {
"NEO4J_URI": "YOUR_NEO4J_URI",
"NEO4J_USERNAME": "YOUR_NEO4J_USERNAME",
"NEO4J_PASSWORD": "YOUR_NEO4J_PASSWORD"
}
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"neo4j-gds-agent": {
"command": "uvx",
"args": [
"gds-agent"
],
"env": {
"NEO4J_URI": "YOUR_NEO4J_URI",
"NEO4J_USERNAME": "YOUR_NEO4J_USERNAME",
"NEO4J_PASSWORD": "YOUR_NEO4J_PASSWORD"
}
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"neo4j-gds-agent": {
"command": "uvx",
"args": [
"gds-agent"
],
"env": {
"NEO4J_URI": "YOUR_NEO4J_URI",
"NEO4J_USERNAME": "YOUR_NEO4J_USERNAME",
"NEO4J_PASSWORD": "YOUR_NEO4J_PASSWORD"
}
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add neo4j-gds-agent --env NEO4J_URI=YOUR_NEO4J_URI --env NEO4J_USERNAME=YOUR_NEO4J_USERNAME --env NEO4J_PASSWORD=YOUR_NEO4J_PASSWORD -- uvx gds-agent{
"mcpServers": {
"neo4j-gds-agent": {
"command": "uvx",
"args": [
"gds-agent"
],
"env": {
"NEO4J_URI": "YOUR_NEO4J_URI",
"NEO4J_USERNAME": "YOUR_NEO4J_USERNAME",
"NEO4J_PASSWORD": "YOUR_NEO4J_PASSWORD"
}
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add neo4j-gds-agent uvx gds-agentGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the neo4j-gds-agent block.
Alternatives to Neo4j GDS Agent
All alternatives →MCP server for interacting with the Supabase platform
Built-in MCP server for ArcadeDB multi-model database (graph, document, vector, time-series)
MCP Toolbox for Databases enables your agent to connect to your database.
MCP Toolbox for Databases enables your agent to connect to your database.
Real-time Kubernetes network traffic visibility and API analysis for HTTP, gRPC, Redis, Kafka, DNS.
Self-learning vector database for Node.js — hybrid search, Graph RAG, FlashAttention-3, HNSW, 50+ attention mechanisms
Neo4j GDS Agent: common questions
How do I install Neo4j GDS Agent?
In Claude Code run claude mcp add neo4j-gds-agent -e NEO4J_URI=YOUR_NEO4J_URI -e NEO4J_USERNAME=YOUR_NEO4J_USERNAME -e NEO4J_PASSWORD=YOUR_NEO4J_PASSWORD -- uvx gds-agent. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is Neo4j GDS Agent the official server?
Neo4j GDS Agent is a community project by neo4j-contrib, not verified by a company domain.
Is Neo4j GDS Agent free?
The code is published under the MIT licence. The service it connects to may have its own pricing.
Is Neo4j GDS Agent safe to use?
It scores 75 of 100. Grades: maintenance A, licence A, quality C. The security check has not run for it yet. Review the code before you install. How grades work.
What are alternatives to Neo4j GDS Agent?
Similar MCP servers: Supabase, ArcadeDB MCP Server, MCP Toolbox for Databases, MCP Toolbox for Databases.
Does Neo4j GDS Agent work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.
