How to Use the Basecamp MCP in Windsurf

Q: How does Windsurf Cascade run Basecamp multi-step tasks?

Cascade reads your intent, calls listprojects to find your workspace, and then loops through listtodos to map your work. It handles this entire chain without asking you for manual input at every turn.

Q: Does Windsurf support real-time updates from Basecamp Campfire?

Cascade fetches the latest chat lines on demand by calling listcampfirelines. It does not maintain a constant websocket connection, but it pulls fresh logs whenever you ask your agent for a status update.

Q: How does the agent know which project to pull?

The agent calls listprojects to scan your account. Once it identifies the correct project name matching your current code repository, it locks onto that workspace ID for subsequent tool calls.

Let Cascade dig through your Basecamp projects and run your team's to-do lists without leaving Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Basecamp MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Audit Basecamp projects automatically in Windsurf

Cascade uses this MCP Server to call `list_projects` and find active workspaces, then pulls the exact tasks you need to focus on. You don't have to click around the Basecamp browser tab when your Windsurf Cascade agent is already looking at your workspace. The Cascade agent chains `get_project` with `list_todolists` to map out your team's current milestones. It matches open code issues in Windsurf to your Basecamp tracking lists instantly.

Dig up context from message boards and Campfires

Stop losing the thread when Basecamp decisions happen in your team's chat. Cascade calls `list_campfire_lines` to pull recent developer discussions directly into your active Windsurf editing session. By combining `list_messages` with your local file context, Cascade finds the exact design decisions your team posted on the Basecamp message board. It keeps your Windsurf code workspace aligned with product specs.

Sync your local workspace tasks with Basecamp todos

Your Cascade agent reads your open files in Windsurf and instantly maps them to active Basecamp assignments. It calls `list_todos` to pull up-to-date Basecamp ticket details right where you write your code. This MCP Server connection helps Cascade verify what Basecamp tasks remain before you commit your changes. You stay in your Windsurf flow state while the tool updates your progress.

Setup guide

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

mcp_config.json

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

Cascade reads your intent, calls `list_projects` to find your workspace, and then loops through `list_todos` to map your work. It handles this entire chain without asking you for manual input at every turn.

Yes, you can add it through the Settings UI under Cascade MCP Servers or write to your local config file. Open `~/.codeium/windsurf/mcp_config.json` and paste the connection details under the mcpServers key.

Cascade fetches the latest chat lines on demand by calling `list_campfire_lines`. It does not maintain a constant websocket connection, but it pulls fresh logs whenever you ask your agent for a status update.

The agent calls `list_projects` to scan your account. Once it identifies the correct project name matching your current code repository, it locks onto that workspace ID for subsequent tool calls.

Your Basecamp todo lists, campfire logs, and project messages never touch external third-party servers. Vinkius runs the server in an isolated sandbox, meaning your company's internal communications remain strictly between your local client and the Basecamp API.

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