Runs Neo4j Graph Data Science algorithms from an agent so it can answer questions that need graph reasoning.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add neo4j-gds-agent --env NEO4J_URI='<NEO4J_URI>' --env NEO4J_USERNAME='<NEO4J_USERNAME>' --env NEO4J_PASSWORD='<NEO4J_PASSWORD>' --env AURA_API_CLIENT_SECRET='<AURA_API_CLIENT_SECRET>' -- uvx gds-agent~/.codex/config.toml
[mcp_servers.neo4j-gds-agent]
command = "uvx"
args = ["gds-agent"]
env = { NEO4J_URI = "<NEO4J_URI>", NEO4J_USERNAME = "<NEO4J_USERNAME>", NEO4J_PASSWORD = "<NEO4J_PASSWORD>", AURA_API_CLIENT_SECRET = "<AURA_API_CLIENT_SECRET>" }
# codex mcp add neo4j-gds-agent --env NEO4J_URI='<NEO4J_URI>' --env NEO4J_USERNAME='<NEO4J_USERNAME>' --env NEO4J_PASSWORD='<NEO4J_PASSWORD>' --env AURA_API_CLIENT_SECRET='<AURA_API_CLIENT_SECRET>' -- uvx gds-agent~/.cursor/mcp.json
{
"mcpServers": {
"neo4j-gds-agent": {
"command": "uvx",
"args": [
"gds-agent"
],
"env": {
"NEO4J_URI": "<NEO4J_URI>",
"NEO4J_USERNAME": "<NEO4J_USERNAME>",
"NEO4J_PASSWORD": "<NEO4J_PASSWORD>",
"AURA_API_CLIENT_SECRET": "<AURA_API_CLIENT_SECRET>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"neo4j-gds-agent": {
"type": "stdio",
"command": "uvx",
"args": [
"gds-agent"
],
"env": {
"NEO4J_URI": "<NEO4J_URI>",
"NEO4J_USERNAME": "<NEO4J_USERNAME>",
"NEO4J_PASSWORD": "<NEO4J_PASSWORD>",
"AURA_API_CLIENT_SECRET": "<AURA_API_CLIENT_SECRET>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"neo4j-gds-agent": {
"command": "uvx",
"args": [
"gds-agent"
],
"env": {
"NEO4J_URI": "<NEO4J_URI>",
"NEO4J_USERNAME": "<NEO4J_USERNAME>",
"NEO4J_PASSWORD": "<NEO4J_PASSWORD>",
"AURA_API_CLIENT_SECRET": "<AURA_API_CLIENT_SECRET>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"neo4j-gds-agent": {
"command": "uvx",
"args": [
"gds-agent"
],
"env": {
"NEO4J_URI": "<NEO4J_URI>",
"NEO4J_USERNAME": "<NEO4J_USERNAME>",
"NEO4J_PASSWORD": "<NEO4J_PASSWORD>",
"AURA_API_CLIENT_SECRET": "<AURA_API_CLIENT_SECRET>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"neo4j-gds-agent": {
"command": "uvx",
"args": [
"gds-agent"
],
"env": {
"NEO4J_URI": "<NEO4J_URI>",
"NEO4J_USERNAME": "<NEO4J_USERNAME>",
"NEO4J_PASSWORD": "<NEO4J_PASSWORD>",
"AURA_API_CLIENT_SECRET": "<AURA_API_CLIENT_SECRET>"
}
}
}
}Environment variables
NEO4J_URINEO4J_USERNAMENEO4J_PASSWORDAURA_API_CLIENT_SECRET
Replace the placeholders with your own credentials and keep them out of version control.