AI Agent Integration
Connect OpenCode to Kanboard
OpenCode is SST'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 OpenCode
opencode.json (project root) or ~/.config/opencode/opencode.json
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"kanboard": {
"type": "remote",
"url": "https://kanboard.io/api/mcp",
"enabled": true,
"headers": { "Authorization": "Bearer {env:KANBOARD_API_KEY}" }
}
}
}3. Verify it works
- Run opencode mcp list — kanboard should appear with its auth status.
- Run opencode mcp debug kanboard for a full connectivity test.
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
- The top-level key is mcp (not mcpServers), and env substitution is {env:VAR} — no dollar sign.
- OpenCode attempts OAuth automatically for some servers; set "oauth": false if that interferes with header auth.
- Default timeout is 5 seconds — raise the timeout field on slow networks.
Full client documentation: OpenCode 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 OpenCode support remote MCP servers?
Yes — OpenCode supports remote MCP servers ("type": "remote") with custom headers and env-var substitution for the key.
Do I need to install anything?
Nothing beyond OpenCode. Add the opencode.json entry, export KANBOARD_API_KEY, done.
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 OpenCode 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.