@headvroom/mcp

MCP (Model Context Protocol) server for Headvroom knowledge graphs.

Enables Claude Desktop, Claude CLI, Cursor, Windsurf, and other MCP-compatible AI tools to access your Headvroom knowledge graphs.

Installation

npx -y @headvroom/mcp

Setup

1. Get an API Key

1. Log in to headvroom.com
2. Click your avatar → Settings
3. Go to API Keys → Generate New Key
4. Copy the key (starts with hv_)

2. Configure Your AI Tool

Claude CLI

claude mcp add --transport stdio --scope user headvroom \
  --env HEADVROOM_API_KEY=hv_your_key_here \
  -- npx -y @headvroom/mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "headvroom": {
      "command": "npx",
      "args": ["-y", "@headvroom/mcp"],
      "env": {
        "HEADVROOM_API_KEY": "hv_your_key_here"
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "headvroom": {
      "command": "npx",
      "args": ["-y", "@headvroom/mcp"],
      "env": {
        "HEADVROOM_API_KEY": "hv_your_key_here"
      }
    }
  }
}

3. Verify

Ask your AI: "What graphs do I have in Headvroom?"

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | HEADVROOM_API_KEY | Yes | Your Headvroom API key (starts with hv_) | | HEADVROOM_API_URL | No | API URL (defaults to https://headvroom.com) |

Available Resources

• headvroom://graphs - List all your knowledge graphs
• headvroom://graph/name/{name} - Get a graph by name
• headvroom://node/{id} - Get node details
• headvroom://nodes/search?query={q} - Search nodes
• headvroom://activity/recent - Recent activity

Documentation

Full documentation: docs.headvroom.com/integrations/mcp

License

MIT