neuroloom-mcp

# neuroloom-mcp MCP server that gives AI coding agents persistent memory via the Neuroloom knowledge graph API. ## Install via pip > Requires Python 3.12+ ```sh pip install neuroloom-mcp neuroloom-mcp install-plugin ``` Then restart Claude Code. The plugin and MCP server are configured together. Set your API key with `/plugins configure neuroloom` in Claude Code. To upgrade: ```sh pip install --upgrade neuroloom-mcp neuroloom-mcp install-plugin --force ``` --- ## Hosted (Cloud) Connection The Neuroloom MCP server is available as a hosted service — no local installation required. **Public endpoint:** `https://mcp.neuroloom.dev/mcp` ### Prerequisites You need a Neuroloom API key. Create one at [app.neuroloom.dev/settings/api-keys](https://app.neuroloom.dev/settings/api-keys). ### Claude Code Create `.mcp.json` in your project root (the directory where you run Claude Code): ```json { "mcpServers": { "neuroloom": { "type": "http", "url": "https://mcp.neuroloom.dev/mcp", "headers": { "Authorization": "Bearer nl_your_api_key_here" } } } } ``` ### Other MCP Clients Any MCP client that supports HTTP (streamable HTTP) transport can connect using the `url` transport type and the `Authorization` header shown above. > **Claude Desktop:** Claude Desktop currently supports only the stdio transport. To use Neuroloom with Claude Desktop, follow the local stdio setup instructions below. ### Verifying Your Connection Check MCP server connectivity (unauthenticated): ```bash curl https://mcp.neuroloom.dev/health ``` Expected response: `{"status": "ok", "version": "0.1.0"}` with HTTP 200. Validate your API key against the Neuroloom API directly: ```bash curl -H "Authorization: Token nl_your_api_key_here" https://api.neuroloom.dev/api/v1/workspaces/ ``` HTTP 200 confirms the key is valid. > **Note:** MCP clients send `Authorization: Bearer <key>`; the Neuroloom API uses `Authorization: Token <key>`. The MCP server tr…