Skip to main content
Glama
Memgraph MCP Server

Memgraph MCP Server

Official
by memgraph
IMPORTANT


This repository has been merged into the Memgraph AI Toolkit monorepo to avoid duplicating tools.
It will be deleted in one month—please follow the MCP integration there for all future development, and feel free to open issues or PRs in that repo.

🚀 Memgraph MCP Server

Memgraph MCP Server is a lightweight server implementation of the Model Context Protocol (MCP) designed to connect Memgraph with LLMs.

mcp-server

⚡ Quick start

📹 Memgraph MCP Server Quick Start video

1. Run Memgraph MCP Server

  1. Install uv and create venv with uv venv. Activate virtual environment with .venv\Scripts\activate.

  2. Install dependencies: uv add "mcp[cli]" httpx

  3. Run Memgraph MCP server: uv run server.py.

2. Run MCP Client

  1. Install Claude for Desktop.

  2. Add the Memgraph server to Claude config:

MacOS/Linux

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows

code $env:AppData\Claude\claude_desktop_config.json

Example config:

{
    "mcpServers": {
      "mpc-memgraph": {
        "command": "/Users/katelatte/.local/bin/uv",
        "args": [
            "--directory",
            "/Users/katelatte/projects/mcp-memgraph",
            "run",
            "server.py"
        ]
     }
   }
}
NOTE


You may need to put the full path to the uv executable in the command field. You can get this by running which uv on MacOS/Linux or where uv on Windows. Make sure you pass in the absolute path to your server.

3. Chat with the database

  1. Run Memgraph MAGE:

    docker run -p 7687:7687 memgraph/memgraph-mage --schema-info-enabled=True

    The --schema-info-enabled configuration setting is set to True to allow LLM to run SHOW SCHEMA INFO query.

  2. Open Claude Desktop and see the Memgraph tools and resources listed. Try it out! (You can load dummy data from Memgraph Lab Datasets)

Related MCP server: mcp-graphql

🔧Tools

run_query()

Run a Cypher query against Memgraph.

🗃️ Resources

get_schema()

Get Memgraph schema information (prerequisite: --schema-info-enabled=True).

🗺️ Roadmap

The Memgraph MCP Server is just at its beginnings. We're actively working on expanding its capabilities and making it even easier to integrate Memgraph into modern AI workflows. In the near future, we'll be releasing a TypeScript version of the server to better support JavaScript-based environments. Additionally, we plan to migrate this project into our central AI Toolkit repository, where it will live alongside other tools and integrations for LangChain, LlamaIndex, and MCP. Our goal is to provide a unified, open-source toolkit that makes it seamless to build graph-powered applications and intelligent agents with Memgraph at the core.

Available Tools

1 tool
run_queryC

Run a query against Memgraph

Inputs: query (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly defined and distinct by default.

    Naming Consistency5/5

    A single tool inherently has perfect naming consistency, as there are no other tools to compare it against. The name 'run_query' follows a clear verb_noun pattern.

    Tool Count2/5

    One tool is too few for a database server's apparent scope, as it severely limits functionality (e.g., no schema management, data manipulation beyond queries, or connection handling). This is a significant mismatch for the domain.

    Completeness1/5

    The tool surface is severely incomplete for a database server. It only supports running queries, lacking essential operations like creating/dropping databases, managing schemas, listing tables, or handling transactions, which will cause frequent agent failures.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables LLMs to interact with GraphQL APIs by providing schema introspection and query execution capabilities.
      936 npm
      3
      MIT
    • A
      license
      D
      quality
      D
      maintenance
      A Model Context Protocol server that enables LLMs to interact with databases (currently MongoDB) through natural language, supporting operations like querying, inserting, deleting documents, and running aggregation pipelines.
      5
      6 npm
      MIT