@xmem-space/mcp

MCP (Model Context Protocol) Server for xmem – persistent memory for AI agents.

Provides 15 tools and 3 resources for storing, searching, and managing memories through any MCP-compatible client.

Install

npm install -g @xmem-space/mcp

Configuration

Environment Variables

Variable	Description	Default
XMEM_API_URL	xmem server URL	http://localhost:18800
XMEM_API_KEY	API key for authentication	(none)
MEMTAP_AGENT_ID	Default agent identifier	main

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "xmem": {
      "command": "xmem-mcp",
      "env": {
        "XMEM_API_URL": "http://localhost:18800",
        "MEMTAP_AGENT_ID": "main"
      }
    }
  }
}

Or with npx (no global install needed):

{
  "mcpServers": {
    "xmem": {
      "command": "npx",
      "args": ["-y", "@xmem-space/mcp"],
      "env": {
        "XMEM_API_URL": "http://localhost:18800",
        "MEMTAP_AGENT_ID": "main"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "xmem": {
      "command": "npx",
      "args": ["-y", "@xmem-space/mcp"],
      "env": {
        "XMEM_API_URL": "http://localhost:18800",
        "MEMTAP_AGENT_ID": "main"
      }
    }
  }
}

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "xmem": {
      "command": "npx",
      "args": ["-y", "@xmem-space/mcp"],
      "env": {
        "XMEM_API_URL": "http://localhost:18800",
        "MEMTAP_AGENT_ID": "main"
      }
    }
  }
}

Tool Reference

Tool	Description
memtap_remember	Store a new memory (fact, decision, preference, event, etc.)
memtap_recall	Full-text search across memories
memtap_bulletin	Context-aware memory retrieval
memtap_graphrag	Deep search with multi-hop graph traversal
memtap_graph	Graph operations: traverse, connections, gaps, clusters, overview
memtap_decide	Create, list, resolve, or defer decisions
memtap_memory	Get, update, or delete a specific memory
memtap_entities	List entities, get linked memories, merge duplicates
memtap_edges	Create relationships between memories
memtap_health	Check server health status
memtap_maintenance	Run maintenance: decay report, contradictions, dedup scan
memtap_consolidate	Full maintenance consolidation in one call
memtap_export	Export memory statistics
memtap_profile	Get memory profile for an agent
memtap_categories	List memory categories with counts

Resources

URI	Description
xmem://health	Server health status
xmem://stats	Memory statistics
xmem://profile/{agentId}	Agent memory profile

Development

npm install
npm run build
npm start

License

MIT