AI Agent Integration
Connect Claude Code to Kanboard
Claude Code is Anthropic's coding agent for the terminal. Connect it to Kanboard's remote MCP server and it can read your board, create tasks, and move work across columns as it ships — nothing to host, nothing to babysit.
1. Create an API key
Go to Settings → Integrations in Kanboard and create an API key. Keys require a Pro subscription. Copy the key — it's shown once.
2. Add the server to Claude Code
Add the server (user scope)
claude mcp add --transport http kanboard https://kanboard.io/api/mcp \
--header "Authorization: Bearer YOUR_API_KEY".mcp.json (project scope, shared with your repo)
{
"mcpServers": {
"kanboard": {
"type": "http",
"url": "https://kanboard.io/api/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}3. Verify it works
- Run claude mcp list — kanboard should show a passing health check.
- Inside a session, run /mcp to see the server and its tools.
- Ask: "list my Kanboard projects" — you should see a list_projects tool call.
Then put the agent to work:
- “Look at my Kanboard board and pick up the top task in To Do.”
- “Break this feature into tasks and add them to my board.”
- “Move everything you finished today to Done.”
Good to know
- Project-scoped .mcp.json servers need a one-time approval the first time claude runs in that repo.
- .mcp.json supports ${VAR} env expansion, so you can keep the key out of version control.
Full client documentation: Claude Code MCP docs
Available tools
| get_board | Full snapshot of a project's columns and tasks |
| list_projects | List all your projects |
| create_project | Create a project with default columns |
| list_tasks | List tasks, optionally by project |
| get_task | Read a task with its description |
| create_task | Add a task to any column |
| update_task | Edit a task's title or description |
| move_task | Move a task across columns |
| delete_task | Remove a task |
FAQ
Does Claude Code support remote MCP servers?
Yes — Claude Code supports remote MCP servers over Streamable HTTP natively, with custom headers for authentication, at local, project, or user scope.
Do I need to install anything?
Nothing beyond Claude Code itself. Kanboard's MCP server is remote — one claude mcp add command and you're connected.
Is the MCP server included in Kanboard's subscription?
Yes. The MCP server and REST API are included in Pro, Kanboard's single plan at $12/month (or $96/year) with unlimited projects and tasks.
What can Claude Code do on my Kanboard board?
Everything the MCP server exposes: list projects, snapshot a board, and create, read, update, move, and delete tasks. A typical flow: you plan tasks in To Do, the agent picks one up, moves it to In Progress, does the work, and moves it to Done.
Where do I get the API key?
Settings → Integrations in Kanboard. Keys require a Pro subscription and are shown once — copy it straight into the config.