OpenMemory MCP Server

MCP (Model Context Protocol) server that provides Claude Desktop with access to your OpenMemory API running on Ubuntu server richard-XPS-15-9560.local:8892.

Architecture

Claude Desktop (Windows)
    ↓ stdio
MCP Server (Python - this package)
    ↓ HTTP REST
OpenMemory API (richard-XPS-15-9560.local:8892)
    ↓
Neo4j + Vector DB (Ubuntu Docker)

Features

The MCP server provides Claude Desktop with the following tools:

search_memories - Semantic search across OpenMemory graph
add_memory - Store new memories with sector classification
list_memories - Browse recent memories with pagination
get_memory - Retrieve specific memory by ID
reinforce_memory - Boost importance of a memory
delete_memory - Remove a memory
health_check - Verify OpenMemory API connectivity

Windows Installation

Prerequisites

Python 3.10 or higher installed on Windows
- Download from: https://www.python.org/downloads/
- During installation, check "Add Python to PATH"
Claude Desktop installed on Windows
- Download from: https://claude.ai/download
Network access to richard-XPS-15-9560.local:8892 from your Windows PC
- Test with: curl http://richard-XPS-15-9560.local:8892/health in PowerShell
- Or open http://richard-XPS-15-9560.local:8892/health in browser

Step 1: Copy Files to Windows

Transfer the entire openmemory-mcp folder to your Windows PC. You can use:

Network share
USB drive
Git clone (if you push this to a repo)
Any file transfer method

Suggested location: C:\Users\YourUsername\openmemory-mcp

Step 2: Install Python Dependencies

Open PowerShell or Command Prompt and navigate to the folder:

cd C:\Users\YourUsername\openmemory-mcp

Install the package and dependencies:

pip install -e .

This will install:

mcp - Model Context Protocol SDK
httpx - HTTP client for API calls
python-dotenv - Environment variable management

Step 3: Configure Claude Desktop

Locate your Claude Desktop configuration file:
- Path: %APPDATA%\Claude\claude_desktop_config.json
- Full path example: C:\Users\YourUsername\AppData\Roaming\Claude\claude_desktop_config.json
Open the file in a text editor (create it if it doesn't exist)
Add the OpenMemory MCP server configuration:

{
  "mcpServers": {
    "openmemory": {
      "command": "python",
      "args": ["-m", "openmemory_mcp"],
      "env": {
        "OPENMEMORY_URL": "http://richard-XPS-15-9560.local:8892"
      }
    }
  }
}

If you already have other MCP servers configured, add the openmemory entry to the existing mcpServers object:

{
  "mcpServers": {
    "existing-server": {
      "command": "...",
      "args": ["..."]
    },
    "openmemory": {
      "command": "python",
      "args": ["-m", "openmemory_mcp"],
      "env": {
        "OPENMEMORY_URL": "http://richard-XPS-15-9560.local:8892"
      }
    }
  }
}

Save the file

Step 4: Restart Claude Desktop

Completely quit Claude Desktop (check system tray)
Restart Claude Desktop
The MCP server should now be available

Testing

Test 1: Network Connectivity

From Windows PowerShell, verify you can reach the OpenMemory API:

curl http://richard-XPS-15-9560.local:8892/health

Expected response:

{"status": "ok", "timestamp": "..."}

Test 2: MCP Server in Claude Desktop

In Claude Desktop, try asking:

"Can you check if OpenMemory is healthy?"

Claude should use the health_check tool and report success.

Test 3: Search Memories

"Search my memories for 'dashboard'"

Test 4: Add Memory

"Add a memory: 'Configured OpenMemory MCP server on Windows' to the semantic sector"

Troubleshooting

"Cannot connect to OpenMemory API"

Check network connectivity from Windows:

ping richard-XPS-15-9560.local
curl http://richard-XPS-15-9560.local:8892/health

Verify OpenMemory container is running on Ubuntu:

docker ps | grep openmemory
docker logs openmemory

Check firewall settings on both Windows and Ubuntu

"Python not found" or "Module not found"

Verify Python is installed:
```
python --version
```

Reinstall dependencies:

cd C:\Users\YourUsername\openmemory-mcp
pip install -e . --force-reinstall

MCP Server Not Showing in Claude Desktop

Check the config file path is correct:
- %APPDATA%\Claude\claude_desktop_config.json
Verify JSON syntax is valid (no trailing commas, proper quotes)
Check Claude Desktop logs (if available)
Completely quit and restart Claude Desktop

Memory Sectors

OpenMemory uses hierarchical memory sectors:

episodic - Event-based memories (what happened)
semantic - Conceptual knowledge (facts, concepts)
procedural - How-to information (processes, workflows)
emotional - User preferences, sentiment
reflective - Meta-learnings, insights

When adding memories, choose the most appropriate sector.

Development

Running Server Manually (for testing)

cd C:\Users\YourUsername\openmemory-mcp
python -m openmemory_mcp

The server will run in stdio mode and wait for MCP protocol messages.

Project Structure

openmemory-mcp/
├── pyproject.toml              # Package configuration
├── README.md                   # This file
├── .env.example                # Environment template
└── src/
    └── openmemory_mcp/
        ├── __init__.py         # Package entry point
        ├── __main__.py         # CLI entry point
        ├── client.py           # OpenMemory API client
        └── server.py           # MCP server implementation

Advanced Configuration

Using API Key Authentication

If your OpenMemory API requires authentication:

Set the API key in Claude Desktop config:

{
  "mcpServers": {
    "openmemory": {
      "command": "python",
      "args": ["-m", "openmemory_mcp"],
      "env": {
        "OPENMEMORY_URL": "http://richard-XPS-15-9560.local:8892",
        "OPENMEMORY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Using Custom OpenMemory URL

If your OpenMemory runs on a different host/port, update the URL:

"env": {
  "OPENMEMORY_URL": "http://different-host:8892"
}

Support

For issues:

Check the troubleshooting section above
Verify OpenMemory API is working directly (curl/browser)
Check Claude Desktop and MCP server logs
Ensure Python dependencies are correctly installed

License

MIT