Kanka MCP Server

A MCP server to manage entries in Kanka platform.

GitHub

Kanka MCP Tool

Local MCP tool for the Kanka worldbuilding API. Runs on your machine via stdio — no remote server needed.

Prerequisites

Install

npm install

Usage

MCP client configuration (Claude Desktop, Cursor, etc.)

Add this to your MCP client config:

{
  "mcpServers": {
    "kanka": {
      "command": "node",
      "args": ["<ABSOLUTE_PATH_TO_REPO>/index.js"],
      "env": {
        "KANKA_API_TOKEN": "<YOUR_KANKA_TOKEN>"
      }
    }
  }
}

Notes:

  • Replace <ABSOLUTE_PATH_TO_REPO> with the full path to this repository.
  • On Windows, prefer forward slashes (C:/Users/...) or escaped backslashes (C:\\Users\\...).
  • Restart the MCP client after editing the config.

Run directly

KANKA_API_TOKEN=your_token npm start

Install globally

npm install -g .
KANKA_API_TOKEN=your_token kanka-mcp

Available tools

The tool exposes 82 MCP tools for interacting with Kanka:

  • list_campaigns — List all campaigns
  • search — Search entities within a campaign
  • For each entity type (Character, Location, Family, Organization, Item, Note, Event, Calendar, Timeline, Creature, Race, Quest, Map, Journal, Ability, Entity):
    • list_<entities> — List all
    • get_<entity> — Get details
    • create_<entity> — Create new
    • update_<entity> — Update existing
    • delete_<entity> — Delete existing

Contributing

Community contributions are welcome.

Local quality checks

npm run lint
npm run format:check
npm test

関連サーバー

NotebookLM Webインポーター

ワンクリックでWebページとYouTube動画をNotebookLMにインポート。200,000人以上のユーザーが利用中。

Chrome拡張機能をインストール