AI Engineer Neo4j Memory MCP Demo

by a-s-g93

329 downloads

Not rated

GitHub

About

A demo project that shows how to configure Claude Desktop with agentic memory using the Neo4j Memory MCP Server. It stores and retrieves conversational context in a Neo4j graph database, allowing memory to persist across sessions and be shared with other MCP-compatible clients.

Details

Author: a-s-g93
Downloads: 329
Categories: Knowledge Base, AI

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name AI Engineer Neo4j Memory MCP Demo

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ai engineer neo4j memory mcp demo": {
            "neo4j-memory-store": {
                "command": "uvx",
                "args": [
                    "mcp-neo4j-memory@0.1.4"
                ],
                "env": {
                    "NEO4J_URL": "bolt://localhost:7687",
                    "NEO4J_USERNAME": "neo4j",
                    "NEO4J_PASSWORD": "password",
                    "NEO4J_DATABASE": "neo4j"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ai engineer neo4j memory mcp demo": {
            "neo4j-memory-store": {
                "command": "uvx",
                "args": [
                    "mcp-neo4j-memory@0.1.4"
                ],
                "env": {
                    "NEO4J_URL": "bolt://localhost:7687",
                    "NEO4J_USERNAME": "neo4j",
                    "NEO4J_PASSWORD": "password",
                    "NEO4J_DATABASE": "neo4j"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ai engineer neo4j memory mcp demo": {
            "neo4j-memory-store": {
                "command": "uvx",
                "args": [
                    "mcp-neo4j-memory@0.1.4"
                ],
                "env": {
                    "NEO4J_URL": "bolt://localhost:7687",
                    "NEO4J_USERNAME": "neo4j",
                    "NEO4J_PASSWORD": "password",
                    "NEO4J_DATABASE": "neo4j"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "ai engineer neo4j memory mcp demo": {
            "neo4j-memory-store": {
                "command": "uvx",
                "args": [
                    "mcp-neo4j-memory@0.1.4"
                ],
                "env": {
                    "NEO4J_URL": "bolt://localhost:7687",
                    "NEO4J_USERNAME": "neo4j",
                    "NEO4J_PASSWORD": "password",
                    "NEO4J_DATABASE": "neo4j"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ai engineer neo4j memory mcp demo": {
            "neo4j-memory-store": {
                "command": "uvx",
                "args": [
                    "mcp-neo4j-memory@0.1.4"
                ],
                "env": {
                    "NEO4J_URL": "bolt://localhost:7687",
                    "NEO4J_USERNAME": "neo4j",
                    "NEO4J_PASSWORD": "password",
                    "NEO4J_DATABASE": "neo4j"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ai engineer neo4j memory mcp demo": {
            "neo4j-memory-store": {
                "command": "uvx",
                "args": [
                    "mcp-neo4j-memory@0.1.4"
                ],
                "env": {
                    "NEO4J_URL": "bolt://localhost:7687",
                    "NEO4J_USERNAME": "neo4j",
                    "NEO4J_PASSWORD": "password",
                    "NEO4J_DATABASE": "neo4j"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ai engineer neo4j memory mcp demo": {
            "neo4j-memory-store": {
                "command": "uvx",
                "args": [
                    "mcp-neo4j-memory@0.1.4"
                ],
                "env": {
                    "NEO4J_URL": "bolt://localhost:7687",
                    "NEO4J_USERNAME": "neo4j",
                    "NEO4J_PASSWORD": "password",
                    "NEO4J_DATABASE": "neo4j"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ai engineer neo4j memory mcp demo": {
            "neo4j-memory-store": {
                "command": "uvx",
                "args": [
                    "mcp-neo4j-memory@0.1.4"
                ],
                "env": {
                    "NEO4J_URL": "bolt://localhost:7687",
                    "NEO4J_USERNAME": "neo4j",
                    "NEO4J_PASSWORD": "password",
                    "NEO4J_DATABASE": "neo4j"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ai engineer neo4j memory mcp demo": {
            "neo4j-memory-store": {
                "command": "uvx",
                "args": [
                    "mcp-neo4j-memory@0.1.4"
                ],
                "env": {
                    "NEO4J_URL": "bolt://localhost:7687",
                    "NEO4J_USERNAME": "neo4j",
                    "NEO4J_PASSWORD": "password",
                    "NEO4J_DATABASE": "neo4j"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "ai engineer neo4j memory mcp demo": {
            "neo4j-memory-store": {
                "command": "uvx",
                "args": [
                    "mcp-neo4j-memory@0.1.4"
                ],
                "env": {
                    "NEO4J_URL": "bolt://localhost:7687",
                    "NEO4J_USERNAME": "neo4j",
                    "NEO4J_PASSWORD": "password",
                    "NEO4J_DATABASE": "neo4j"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ai engineer neo4j memory mcp demo": {
            "neo4j-memory-store": {
                "command": "uvx",
                "args": [
                    "mcp-neo4j-memory@0.1.4"
                ],
                "env": {
                    "NEO4J_URL": "bolt://localhost:7687",
                    "NEO4J_USERNAME": "neo4j",
                    "NEO4J_PASSWORD": "password",
                    "NEO4J_DATABASE": "neo4j"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ai engineer neo4j memory mcp demo": {
            "neo4j-memory-store": {
                "command": "uvx",
                "args": [
                    "mcp-neo4j-memory@0.1.4"
                ],
                "env": {
                    "NEO4J_URL": "bolt://localhost:7687",
                    "NEO4J_USERNAME": "neo4j",
                    "NEO4J_PASSWORD": "password",
                    "NEO4J_DATABASE": "neo4j"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ai engineer neo4j memory mcp demo": {
            "neo4j-memory-store": {
                "command": "uvx",
                "args": [
                    "mcp-neo4j-memory@0.1.4"
                ],
                "env": {
                    "NEO4J_URL": "bolt://localhost:7687",
                    "NEO4J_USERNAME": "neo4j",
                    "NEO4J_PASSWORD": "password",
                    "NEO4J_DATABASE": "neo4j"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ai engineer neo4j memory mcp demo": {
            "neo4j-memory-store": {
                "command": "uvx",
                "args": [
                    "mcp-neo4j-memory@0.1.4"
                ],
                "env": {
                    "NEO4J_URL": "bolt://localhost:7687",
                    "NEO4J_USERNAME": "neo4j",
                    "NEO4J_PASSWORD": "password",
                    "NEO4J_DATABASE": "neo4j"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ai engineer neo4j memory mcp demo": {
            "neo4j-memory-store": {
                "command": "uvx",
                "args": [
                    "mcp-neo4j-memory@0.1.4"
                ],
                "env": {
                    "NEO4J_URL": "bolt://localhost:7687",
                    "NEO4J_USERNAME": "neo4j",
                    "NEO4J_PASSWORD": "password",
                    "NEO4J_DATABASE": "neo4j"
                }
            }
        }
    }
}

From the repository

Install uv (Python package manager), create a Neo4j instance (Aura cloud or Desktop), then edit Claude Desktop’s MCP config file with the neo4j-memory-store server command, credentials, and the provided system prompt. After setup, start conversations in Claude Desktop – each interaction is automatically logged in Neo4j.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "ai engineer neo4j memory mcp demo": {
            "neo4j-memory-store": {
                "command": "uvx",
                "args": [
                    "mcp-neo4j-memory@0.1.4"
                ],
                "env": {
                    "NEO4J_URL": "bolt://localhost:7687",
                    "NEO4J_USERNAME": "neo4j",
                    "NEO4J_PASSWORD": "password",
                    "NEO4J_DATABASE": "neo4j"
                }
            }
        }
    }
}

McpServers

{
    "neo4j-memory-store": {
        "command": "uvx",
        "args": [
            "mcp-neo4j-memory@0.1.4"
        ],
        "env": {
            "NEO4J_URL": "bolt://localhost:7687",
            "NEO4J_USERNAME": "neo4j",
            "NEO4J_PASSWORD": "password",
            "NEO4J_DATABASE": "neo4j"
        }
    }
}

AI Engineer Neo4j Memory MCP Demo

This is a short demo of the Neo4j Memory MCP server.

This file descibes how to configure Claude Desktop with agentic memory courtesy of the Neo4j Memory MCP Server.

Set Up

Install uv Python Package Manager

The Neo4j Memory MCP Server is written in Python and managed by uv. Follow the directions on this page to properly install.

Neo4j Database

Create a Neo4j database instance by either
Navigating to the Neo4j Aura Console to create a cloud hosted Neo4j Aura instance
Downloading Neo4j Desktop and creating a local Neo4j instance

Claude Desktop

Download Claude Desktop navigate to Settings -> Developer -> Edit Config Add the Neo4j Memory MCP server to the config file

You may replace the config values with your own database credentials

{
  "mcpServers": {
    "neo4j-memory-store": {
      "command": "uvx",
      "args": [ "mcp-neo4j-memory@0.1.4" ],
      "env": {
        "NEO4J_URL": "bolt://localhost:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "password",
        "NEO4J_DATABASE": "neo4j"
      }
    }
  }
}

Navigate to Settings -> General -> Claude Settings -> Configure
In the personal preferences section - paste this text:

Follow these steps for each interaction: 1. Memory Retrieval: - Always begin your chat by saying only "Remembering..." and retrieve all relevant information from your knowledge graph - Always refer to your knowledge graph as your "memory"

2. Memory Update: - If any new information was gathered during the interaction, update your memory as follows: a) Create entities for recurring organizations, people, and significant events b) Connect them to the current entities using relations b) Store facts about them as observations

This text is a modified version of the system prompt Anthropic recommends for their memory MCP server.

Demo

Begin a conversation with Claude Desktop.

Each interaction should be automatically logged in the Neo4j database you've configured.

These memories may be used between different conversations with Claude and even accessed by other clients such as Cursor or Windsurf, if they are configured with the same Neo4j instance.

Example Knowledge Graph

This knowledge graph contains the semantic memories of our conversation.

knowledge-graph

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

AI Engineer Neo4j Memory MCP Demo

Set Up

Install uv Python Package Manager

Neo4j Database

Claude Desktop

Demo

Example Knowledge Graph

Install

More like this

Aws Kb Retrieval Server

Memory

Context 7

1Panel

🔎 GPT Researcher

Serena