AI Agent Integration
Connect Windsurf to Kanboard
Windsurf is Cognition's AI-powered editor. 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 Windsurf
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"kanboard": {
"serverUrl": "https://kanboard.io/api/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}3. Verify it works
- Open the MCP panel from the Cascade toolbar and refresh — kanboard should list its tools.
- Ask Cascade to list your Kanboard projects.
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 URL field is serverUrl — a plain url key won't work in Windsurf.
- Supports ${env:VAR} and ${file:/path} interpolation if you'd rather not inline the key.
- Windsurf caps total MCP tools at 100 across all configured servers.
Full client documentation: Windsurf 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 Windsurf support remote MCP servers?
Yes — Windsurf's Cascade connects to remote Streamable HTTP servers with custom headers via the serverUrl field in mcp_config.json.
Do I need to install anything?
Nothing. Edit mcp_config.json (or use the Cascade MCP panel) and refresh — the server is remote.
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 Windsurf 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.