How to Use the Trello MCP in Windsurf

Q: How do I search for Trello cards using Windsurf?

Just call the searchcards tool. You provide keywords, and Windsurf will return matching cards, complete with board and list context. It’s a targeted way to find what you need.

Q: Can I manage labels on Trello boards using Windsurf?

Yeah, absolutely. First, run listlabels to grab all the available label IDs for the board. Then, use those IDs with addlabeltocard to stick a new label onto any card.

Q: What happens if I need to check details about Trello boards using Windsurf?

You can get general board information using getboard. This tool fetches all the core data for that specific Trello board. It's useful before you decide which cards you want to manipulate.

Automate your project management goals with Windsurf. Cascade handles the Trello API calls 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 Trello MCP to Windsurf

Create your Vinkius account to connect Trello 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 Trello with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage Board Contents

Want a full picture of a board? Use `list_board_cards` to get all cards across every list in a single go. You can also check out the overall structure with `list_lists`, which gives you the column names. Need specific data? Run `search_cards` to filter for matching cards using keywords, giving you focused results without manually checking each card.

Update and Create Cards

Don't just read—change things. You can use `create_card` to spin up a new card right on the board. Later, if something changes, `update_card` lets you modify details on an existing card. Remember that when archiving, it’s better to set `closed: true` instead of using `delete_card`. This keeps your history intact.

Track Board Activity

`add_comment` lets you drop a comment right into the card activity feed, and everyone watching gets notified. It’s great for quick status updates. If you need to track who's involved, `list_members` shows you all users associated with that board. You can also check out the whole membership list using `get_me`.

Setup guide

Set up Trello 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 Trello 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 Trello payment history." If connected, Cascade will call the Trello tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "trello-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 Trello. 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 Trello 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 Trello MCP in Windsurf

Just call the `search_cards` tool. You provide keywords, and Windsurf will return matching cards, complete with board and list context. It’s a targeted way to find what you need.

Yeah, absolutely. First, run `list_labels` to grab all the available label IDs for the board. Then, use those IDs with `add_label_to_card` to stick a new label onto any card.

You can get general board information using `get_board`. This tool fetches all the core data for that specific Trello board. It's useful before you decide which cards you want to manipulate.

The best practice is always updating a card by setting it as closed (`true`). If you still need to delete, use `delete_card`, but remember that keeping the archive record via updates is usually better for tracking.

The server interacts with board and card metadata, including titles, descriptions, labels, member lists, and comments. It's all structural information about the project.

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