MindReader MCP Server

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+

Related MCP server: Semantic Notes Vault MCP

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

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

License

MIT