Graphiti MCP Server

Graphiti is a framework for building and querying temporally-aware knowledge graphs, specifically tailored for AI agents operating in dynamic

Local serverstdioPython

What is the Graphiti MCP Server?

Graphiti is a framework for building and querying temporally-aware knowledge graphs, specifically tailored for AI agents operating in dynamic environments. Unlike

The short version

  • Episode Management — Add, retrieve, and delete episodes (text, messages, or JSON data)
  • Entity Management — Search and manage entity nodes and relationships in the knowledge graph
  • Search Capabilities — Search for facts (edges) and node summaries using semantic and hybrid search
  • Group Management — Organize and manage groups of related data with group_id filtering
  • Graph Maintenance — Clear the graph and rebuild indices

What it needs from you

  1. Ensure you have Python 3.10 or higher installed. 2. A running Neo4j database (version 5.26 or later required) 3. OpenAI API key for LLM operations

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.

ToolWhat it does
add_episodeAdd an episode to the knowledge graph (supports text, JSON, and message formats)
search_nodesSearch the knowledge graph for relevant node summaries
search_factsSearch the knowledge graph for relevant facts (edges between entities)
delete_entity_edgeDelete an entity edge from the knowledge graph
delete_episodeDelete an episode from the knowledge graph
get_entity_edgeGet an entity edge by its UUID
get_episodesGet the most recent episodes for a specific group
clear_graphClear all data from the knowledge graph and rebuild indices
get_statusGet the status of the Graphiti MCP server and Neo4j connection

How to install the Graphiti MCP Server

{
  "mcpServers": {
    "graphiti-memory": {
      "transport": "stdio",
      "command": "/Users/<user>/.local/bin/uv",
      "args": [
        "run",
        "--isolated",
        "--directory",
        "/Users/<user>>/dev/zep/graphiti/mcp_server",
        "--project",
        ".",
        "graphiti_mcp_server.py",
        "--transport",
        "stdio"
      ],
      "env": {
        "NEO4J_URI": "bolt://localhost:7687",
        "NEO4J_USER": "neo4j",
        "NEO4J_PASSWORD": "YOUR_NEO4J_PASSWORD",
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY",
        "MODEL_NAME": "gpt-4.1-mini"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  1. Ensure you have Python 3.10 or higher installed. 2. A running Neo4j database (version 5.26 or later required) 3. OpenAI API key for LLM operations
VariableDescriptionRequired
NEO4J_URIDeclared in the maintainer’s client configuration.Check documentation
NEO4J_USERDeclared in the maintainer’s client configuration.Check documentation
NEO4J_PASSWORDDeclared in the maintainer’s client configuration.Check documentation
OPENAI_API_KEYDeclared in the maintainer’s client configuration.Yes
MODEL_NAMEDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Graphiti to add episode.”
  • “Use Graphiti to search nodes.”
  • “Use Graphiti to search facts.”

Frequently asked questions

Graphiti is a framework for building and querying temporally-aware knowledge graphs, specifically tailored for AI agents operating in dynamic environments. Unlike Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.