How to Use the KanbanTool MCP in Windsurf

Q: Can I use Windsurf to manage tasks across multiple KanbanTool boards?

Yes. Cascade can use listboards to see all your projects. You can tell it to perform actions across several boards, like finding all tasks assigned to you, regardless of which board they're on.

Let Windsurf's Cascade agent manage your KanbanTool projects. Set a high-level goal, and it executes the multi-step plan for you.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect KanbanTool MCP to Windsurf

Create your Vinkius account to connect KanbanTool to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup KanbanTool with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous Board Management

This isn't about running one command at a time. Tell Windsurf's Cascade agent, "Clean up the main project board." It will use `list_boards` to find the right one, `get_board_details` to see what's active, and then decide which old tasks need to be archived with `archive_task_card`. You don't give it a script. You give it an objective. Cascade forms its own plan to query task history with `list_task_activities` and determines what's stale, all without asking you at each step. It's true autonomous operation inside your IDE.

Chain Task Creation and Assignment

Stop switching contexts to create tickets. Just tell your agent, "Log a bug for the SSO failure and assign it to me." Cascade handles the rest, chaining together the necessary actions. First, it calls `create_task_card` to get the ticket on the board. Then, it immediately follows up with `update_task_details` to set you as the assignee and add any other context from your prompt. One request from you results in a complete, assigned task in KanbanTool.

Generate Project Summaries on Demand

Ask Windsurf for a status update and it pulls the raw data directly from KanbanTool. A prompt like "Summarize the 'Q3 Features' board" kicks off a sequence of tool calls that you don't have to manage. Cascade will `list_board_tasks`, then loop through the results, calling `get_task_details` for specifics and `list_task_activities` to check for recent progress. It assembles the information and presents a summary right in your editor, built from live project data.

Setup guide

Set up KanbanTool MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the KanbanTool MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my KanbanTool payment history." If connected, Cascade will call the KanbanTool tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "kanbantool-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by KanbanTool. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect KanbanTool now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about KanbanTool MCP in Windsurf

You give Cascade a goal, and it creates a plan using the available KanbanTool MCP tools. It can chain commands like `list_boards` and `list_board_tasks` to find what it needs, then act on it with `update_task_details` or `archive_task_card`, all in one autonomous run.

Yes. Cascade can use `list_boards` to see all your projects. You can tell it to perform actions across several boards, like finding all tasks assigned to you, regardless of which board they're on.

No, because you set the objective. Cascade is a tool for executing your intent. If you tell it to archive stale cards on KanbanTool, it uses `list_task_activities` to make an informed decision, giving you a powerful way to enforce board hygiene.

It's fast. You can use the built-in MCP Marketplace in Windsurf to install the KanbanTool server with one click. Or, you can manually add the server URL to your `mcp_config.json` file.

Windsurf only accesses the data its agent needs for a specific task. If it's updating a card, it uses `update_task_details` and only sees data for that card. All requests are proxied through the Vinkius MCP server, which runs in an ephemeral, sandboxed environment.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript