Skip to content

MCP Configuration for BrainLayer

Add this to ~/.claude/settings.json under mcpServers:

{
  "mcpServers": {
    "brainlayer": {
      "command": "python",
      "args": ["-m", "brainlayer.mcp"],
      "cwd": "/path/to/brainlayer"
    }
  }
}

Or if you have brainlayer installed globally:

{
  "mcpServers": {
    "brainlayer": {
      "command": "brainlayer-mcp",
      "args": []
    }
  }
}

Testing the MCP Server

  1. Start the server manually to test:

    cd /path/to/brainlayer
    source .venv/bin/activate
    python -m brainlayer.mcp
    

  2. In Claude Code, the tools should appear:

  3. brain_search - Unified semantic search (query, file_path, chunk_id, filters)
  4. brain_store - Persist memories (ideas, decisions, learnings)
  5. brain_recall - Proactive retrieval (context, sessions, summaries)

Old brainlayer_* names still work as backward-compat aliases.