kaiten-connector

Kaiten MCP Server

Remote MCP server that connects Claude to Kaiten project management. Deploy your own instance, add it as a custom connector in Claude, and work with your boards, cards, sprints, and backlog directly from chat.

What you can do

Tool	Description
list-boards	List all spaces and boards, optionally filter by name
get-board	Board structure: columns with types and WIP limits, subcolumns, lanes
list-cards	Cards with flexible filters: board, column, lane, member, owner, sprint, tags, state, dates, overdue, ASAP, text search
search-cards	Search cards across all boards by text query
get-card	Full card details: description, comments, checklists, blockers, children, parents, external links, files, time logs, custom properties, location history
get-card-blockers	Detailed blocker info: reason, blocking card, released status, due date
get-card-time-logs	Time tracking logs: who spent how much time, on which date, with what role
get-card-external-links	External links attached to a card
list-sprints	Sprints with filtering by active status, velocity, committed points
get-sprint-cards	Cards in a specific sprint
get-current-user	Currently authenticated user info
backlog-analytics	Board analytics: distribution by column, blockers, workload, aging, due dates

Quick start

1. Get your Kaiten API token

Go to your Kaiten profile page Settings > API keys > create a new token.

Your Kaiten host is the full domain from your browser URL bar, e.g. mycompany.kaiten.ru.

2. Deploy to Railway

1. Create a new project on railway.app > Deploy from GitHub Repo
2. Connect this repo (fork it first if needed)
3. Go to the service > Variables tab > add variables via Raw Editor:

KAITEN_HOST=mycompany.kaiten.ru
KAITEN_TOKEN=your-kaiten-api-token
OAUTH_CLIENT_ID=kaiten-claude
OAUTH_CLIENT_SECRET=generate-a-long-random-string
OWNER_PASSWORD=set-a-strong-password
OAUTH_REDIRECT_URIS=https://claude.ai/api/mcp/auth_callback
PORT=3000

Generate OAUTH_CLIENT_SECRET with: openssl rand -hex 32

Generate OWNER_PASSWORD with: openssl rand -base64 24 (or pick a long passphrase you can remember — you'll type it each time you reconnect Claude).

OAUTH_REDIRECT_URIS is a comma-separated whitelist of allowed OAuth callback URIs. For Claude custom connectors, use https://claude.ai/api/mcp/auth_callback. If Claude shows a different URI during the authorize flow, add it here and redeploy.

Raw Editor quirk: Railway stores values literally, including any surrounding quotes you paste. The server defensively strips a matching pair of outer single/double quotes from every env var, so both KAITEN_HOST=mycompany.kaiten.ru and KAITEN_HOST="mycompany.kaiten.ru" work. Unquoted form is still recommended (fewer surprises in downstream tooling).

The server will refuse to start if any of OAUTH_CLIENT_ID, OAUTH_CLIENT_SECRET, OWNER_PASSWORD, OAUTH_REDIRECT_URIS, KAITEN_HOST, or KAITEN_TOKEN is missing. This is intentional — it prevents an accidentally-misconfigured instance from running with authentication disabled.

4. Go to Settings > Networking > Generate Domain
5. Wait for the deploy to finish
6. Verify: open https://your-domain.up.railway.app/health — should return {"status":"ok"}

3. Connect to Claude

1. Open claude.ai > bottom-left profile icon > Settings
2. Go to Integrations > Add custom connector
3. Fill in:
   • Name: Kaiten
   • Remote MCP server URL: https://your-domain.up.railway.app/mcp
   • Open Advanced settings:
     • OAuth Client ID: same value as your OAUTH_CLIENT_ID (e.g. kaiten-claude)
     • OAuth Client Secret: same value as your OAUTH_CLIENT_SECRET
4. Click Add
5. Click Connect next to the new connector — a consent page will open
6. Enter your OWNER_PASSWORD on the consent page, then click Authorize — you'll be redirected back to Claude

Done! Now in any Claude chat, you can ask things like:

• "Show my Kaiten boards"
• "What cards are on board 123?"
• "Give me backlog analytics for board 456"
• "Who's on the team?"

Alternative: Deploy to Render

The repo includes render.yaml for one-click deploy on Render. Same environment variables apply.

Alternative: Run locally

git clone https://github.com/Stillfrozen/kaiten-connector.git
cd kaiten-connector
npm install
npm run build

# Local dev (unauthenticated — explicit opt-in)
ALLOW_UNAUTHENTICATED=1 \
KAITEN_HOST=mycompany.kaiten.ru \
KAITEN_TOKEN=your-token \
npm start

For development with auto-reload: