Configure MemoryGraph with Windsurf (Codeium's AI editor).

Prerequisites

• Windsurf installed
• Python 3.10 or higher
• MemoryGraph installed

Setup Steps

Step 1: Install MemoryGraph

pipx install memorygraphMCP

Step 2: Find memorygraph Path

which memorygraph
# Example: /Users/yourname/.local/bin/memorygraph

Step 3: Configure Windsurf

Open Windsurf Settings and locate MCP configuration. Add the memorygraph server:

{
  "mcpServers": {
    "memorygraph": {
      "command": "/Users/yourname/.local/bin/memorygraph",
      "args": []
    }
  }
}

Step 4: Restart Windsurf

Restart Windsurf for the configuration to take effect.

Important: Add Memory Directives

MemoryGraph won't automatically store memories. You need to add memory directives to tell Windsurf when and what to remember.

Add to your project rules

Create a rules file (e.g., .windsurfrules or project instructions):

## Memory Protocol

### Before Starting Work
Use `recall_memories` before any task.

### Store Memories When:
- Fixing a bug → problem + solution
- Making architecture decisions
- Discovering reusable patterns

Always include tags, importance (0-1), and relationships.

→ Full Memory Protocol Guide with complete directives.

Verify Setup

Ask Windsurf's AI to test memory:

"Store a memory that I configured MemoryGraph with Windsurf"

Troubleshooting

• Verify Windsurf version supports MCP
• Check that memorygraph runs: memorygraph --health
• Use absolute path to memorygraph binary

See the Troubleshooting Guide for more help.