Kanka

Provides CRUD access to Kanka campaigns, with enhanced search, batch operations, and sync support.

python

1

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ervwalter-mcp-kanka": {
      "command": "python",
      "args": [
        "-m",
        "mcp_kanka"
      ],
      "env": {
        "KANKA_TOKEN": "YOUR_TOKEN",
        "KANKA_CAMPAIGN_ID": "YOUR_CAMPAIGN_ID"
      }
    }
  }
}

You run the MCP server to empower AI assistants to interact with your Kanka campaigns. It exposes operations for managing entities and posts, supports advanced search and batch actions, and keeps timestamps to help you track changes. This guide shows how to use, install, and configure the Kanka MCP server so you can automate campaigns safely and efficiently.

How to use

You connect your MCP client to the Kanka MCP Server to perform create, read, update, and delete operations on Kanka entities, manage posts, and run batch actions. You can filter and search entities, sync efficiently using timestamps, and keep a clear audit trail of changes.

To run the server locally with Claude Desktop, configure the MCP server entry to start via Python and load your Kanka credentials. You will provide the Kanka API token and campaign ID as environment variables so the server can access your Kanka data securely.

{
  "mcpServers": {
    "kanka": {
      "command": "python",
      "args": ["-m", "mcp_kanka"],
      "env": {
        "KANKA_TOKEN": "your-token",
        "KANKA_CAMPAIGN_ID": "your-campaign-id"
      }
    }
  }
}

How to use with Claude Code CLI

If you prefer configuring the MCP server through code, start the server using the Python module in your environment. Provide your Kanka credentials as environment variables when launching.

claude mcp add kanka \
  -e KANKA_TOKEN="your-token" \
  -e KANKA_CAMPAIGN_ID="your-campaign-id" \
  -- python -m mcp_kanka

Available tools

find_entities

Search and filter entities with comprehensive options and sync metadata.

create_entities

Create one or more entities with markdown content.

update_entities

Update one or more existing entities.

get_entities

Retrieve specific entities by ID with optional posts.

delete_entities

Delete one or more entities.

check_entity_updates

Efficiently check which entities have been modified since last sync.

create_posts

Add posts to entities.

update_posts

Modify existing posts.

delete_posts

Remove posts from entities.