Mindreader

Connect MindReader to Claude Code, Cursor, or any MCP-compatible client. Gives your AI assistant persistent memory backed by a knowledge graph.

Prerequisites

• MindReader V2 running locally (npm start)
• Node.js 18+

Install

git clone https://github.com/flu012/mindreader-mcp.git
cd mindreader-mcp
npm install

Setup with Claude Code

Add to your Claude Code settings (~/.claude/settings.json or project .claude/settings.json):

{
  "mcpServers": {
    "mindreader": {
      "command": "node",
      "args": ["/path/to/mindreader-mcp/src/index.js"],
      "env": {
        "MINDREADER_URL": "http://localhost:18900"
      }
    }
  }
}

If MindReader has authentication enabled, add your token:

{
  "mcpServers": {
    "mindreader": {
      "command": "node",
      "args": ["/path/to/mindreader-mcp/src/index.js"],
      "env": {
        "MINDREADER_URL": "http://localhost:18900",
        "MINDREADER_TOKEN": "your-api-token"
      }
    }
  }
}

Setup with Cursor

Add to Cursor's MCP settings (~/.cursor/mcp.json):

{
  "mcpServers": {
    "mindreader": {
      "command": "node",
      "args": ["/path/to/mindreader-mcp/src/index.js"],
      "env": {
        "MINDREADER_URL": "http://localhost:18900"
      }
    }
  }
}

Tools

Tool	Description
memory_search	Search the knowledge graph for entities, facts, and relationships
memory_store	Store information using LLM preprocessing (auto-extracts entities)
memory_create	Create/update entities directly without LLM (precise control)
memory_entities	List entities in the knowledge graph
memory_recall	Recall relevant memories for a given context
memory_stats	Get knowledge graph statistics

Examples

Once configured, Claude Code can use the tools naturally:

• "Remember that Alice is a senior engineer at Acme Corp"
• "What do you know about the payments project?"
• "List all the entities in my knowledge graph"
• "Create an entity for the new API gateway project with tags backend, infrastructure"

Environment Variables

Variable	Default	Description
MINDREADER_URL	http://localhost:18900	MindReader API base URL
MINDREADER_TOKEN	(empty)	Bearer token for authentication

License

MIT