What are the prerequisites?

Node.js 18+ and a running PuppyGraph instance are required.

How do I configure connection details?

Set environment variables like `PUPPYGRAPH_URL`, `PUPPYGRAPH_USERNAME`, and `PUPPYGRAPH_PASSWORD`, or specify them in the `env` section of the Claude Desktop MCP config.

What credentials does it need?

It reads `PUPPYGRAPH_URL`, `PUPPYGRAPH_USERNAME`, `PUPPYGRAPH_PASSWORD`, `PUPPYGRAPH_DATABASE`, `PUPPYGRAPH_GREMLIN_URL`, `PUPPYGRAPH_GREMLIN_USERNAME`, `PUPPYGRAPH_GREMLIN_PASSWORD`, `PUPPYGRAPH_SCHEMA_URL` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

PuppyGraph MCP Server

# PuppyGraph MCP Server Model Context Protocol (MCP) server for [PuppyGraph](https://puppygraph.com), allowing Claude to query the graph using

Local serverstdio

What is the PuppyGraph MCP Server?

PuppyGraph MCP Server Model Context Protocol (MCP) server for PuppyGraph, allowing Claude to query the graph using Gremlin and Cypher

What the server does

Connect to PuppyGraph instances using both Neo4j Bolt protocol (for Cypher) and WebSocket (for Gremlin)
Query graph data using both Gremlin and Cypher query languages
Retrieve graph structure and schema information from multiple endpoints
Works with Claude Desktop and other MCP-compatible interfaces
Robust fallback mechanisms with multiple connection approaches
Graceful degradation with sample data when connections fail

Credentials and setup notes

Node.js 18+ - A running PuppyGraph instance (or fallback mode for testing)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
puppygraph_query	Execute Gremlin or Cypher queries against PuppyGraph
puppygraph_schema	Get schema and structure information about the graph
puppygraph_status	Check PuppyGraph connection status

How to install the PuppyGraph MCP Server

{
  "mcpServers": {
    "puppygraph": {
      "command": "node",
      "args": [
        "/path/to/puppygraph-mcp/build/index.js"
      ],
      "env": {
        "PUPPYGRAPH_URL": "bolt://your-neo4j-server:7687",
        "PUPPYGRAPH_USERNAME": "neo4j",
        "PUPPYGRAPH_PASSWORD": "your-password",
        "PUPPYGRAPH_DATABASE": "your-database",
        "PUPPYGRAPH_GREMLIN_URL": "ws://your-gremlin-server:8182/gremlin",
        "PUPPYGRAPH_GREMLIN_USERNAME": "your-username",
        "PUPPYGRAPH_GREMLIN_PASSWORD": "your-password"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Node.js 18+ - A running PuppyGraph instance (or fallback mode for testing)

Variable	Description	Required
PUPPYGRAPH_URL	Endpoint or connection string the server talks to.	Yes
PUPPYGRAPH_USERNAME	Configuration value read at startup.	Optional
PUPPYGRAPH_PASSWORD	Configuration value read at startup.	Optional
PUPPYGRAPH_DATABASE	Configuration value read at startup.	Optional
PUPPYGRAPH_GREMLIN_URL	Endpoint or connection string the server talks to.	Yes
PUPPYGRAPH_GREMLIN_USERNAME	Configuration value read at startup.	Optional
PUPPYGRAPH_GREMLIN_PASSWORD	Configuration value read at startup.	Optional
PUPPYGRAPH_SCHEMA_URL	Endpoint or connection string the server talks to.	Yes