How to Use the Sunsama MCP in Windsurf

Q: Can I check my available projects in Sunsama using Windsurf?

Yep. The listcontexts tool shows all the structured contexts within Sunsama. This helps you keep work separate and focused when juggling multiple client accounts.

Q: How do I delete a task permanently from Sunsama with Windsurf?

You use the deletetask function. Just remember, this action is final; it removes the entry from Sunsama's record entirely.

Q: Does Sunsama support multiple channels in Windsurf?

Yes. You can check which channels are available using listchannels. This makes sure your agent knows whether to treat the task as 'Work' or 'Personal'.

Automate your daily flow in Sunsama using Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Sunsama MCP to Windsurf

Create your Vinkius account to connect Sunsama to Windsurf — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Sunsama with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Manage tasks across projects.

Need to add a follow-up item? Your agent handles it. You can use `create_task` to drop a new action into Sunsama, specifying the required text and even setting a planned date. If you change your mind or the due date shifts, just tell Windsurf to run `update_task`. It modifies the existing entry without needing you to manually edit the web app.

Understand project boundaries.

The agent knows where you are working. Use `list_contexts` to see all the separate areas or projects Sunsama tracks for you, letting you switch focus instantly. It also runs `get_user_profile` so your workflow always uses the correct contact details or user context before making changes.

Review and filter tasks.

Don't want to scroll through everything? The tool lets you run `list_tasks` and apply date filters. It pulls every task from Sunsama, so you only see what's due this week. Want a quick overview of all available channels? Just call `list_channels`. This shows the high-level categories like 'Work' or 'Personal' right in your IDE.

Setup guide

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

mcp_config.json

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

Windsurf treats Sunsama as a live data source. You don't have to switch tabs; your agent talks directly to the Sunsama API inside your IDE, letting you manage tasks on the fly.

Yep. The `list_contexts` tool shows all the structured contexts within Sunsama. This helps you keep work separate and focused when juggling multiple client accounts.

You use the `delete_task` function. Just remember, this action is final; it removes the entry from Sunsama's record entirely.

Yes. You can check which channels are available using `list_channels`. This makes sure your agent knows whether to treat the task as 'Work' or 'Personal'.

This MCP Server deals with structured tasks and user profiles. It modifies, retrieves, and lists `tasks` within your personal Sunsama workspace.

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