Campaign Grimoire MCP Bridge

Connect Claude Desktop to your Campaign Grimoire campaigns using the Model Context Protocol (MCP).

Setup

1. Get Your MCP Token

1. Open your campaign in Campaign Grimoire
2. Go to Settings > MCP Configuration
3. Click Create Token and copy the token (you'll only see it once!)

2. Configure Claude Desktop

Open your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the Campaign Grimoire server:

{
  "mcpServers": {
    "campaign-grimoire": {
      "command": "npx",
      "args": ["-y", "campaign-grimoire-mcp"],
      "env": {
        "MCP_SSE_URL": "https://your-server.com/api/v1/mcp/YOUR_CAMPAIGN_ID/sse",
        "MCP_TOKEN": "mcp_xxxxxxxx_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      }
    }
  }
}

Replace:

• YOUR_CAMPAIGN_ID with your campaign's UUID (shown in the MCP Configuration page)
• mcp_xxxxxxxx_... with your token from step 1

3. Restart Claude Desktop

Restart Claude Desktop to load the new configuration. You should see Campaign Grimoire in the MCP servers list.

Available Tools

Once connected, Claude will have access to:

• list_entities - List all entities in your campaign (characters, locations, items, etc.)
• get_entity - Get detailed information about a specific entity
• search_entities - Search entities by name or content
• create_entity - Create new campaign entities
• update_entity - Update existing entities
• list_sessions - List game sessions
• get_session - Get session details and notes

Troubleshooting

"Connection closed" error on Windows

On Windows, you may need to wrap the command:

{
  "mcpServers": {
    "campaign-grimoire": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "campaign-grimoire-mcp"],
      "env": {
        "MCP_SSE_URL": "...",
        "MCP_TOKEN": "..."
      }
    }
  }
}

Authentication failed

Make sure your token:

1. Is copied correctly (including the mcp_ prefix)
2. Has not been revoked
3. Has not expired

Connection error

Verify that:

1. The Campaign Grimoire server is running
2. Your MCP_SSE_URL is correct
3. Your network allows HTTPS connections

License

MIT