How to Use the Ellie Planner MCP in Windsurf

Q: Can Windsurf and Ellie Planner create nested subtasks?

Yes. Cascade uses createtask multiple times in a single run to break large features into smaller tickets. It maps out the entire sequence automatically via the MCP integration.

Q: Will Ellie Planner overwrite my existing Windsurf project lists?

No. The agent reads your current structure using listlists first. It appends new items rather than destroying your existing organization.

Manage tasks and project boards directly inside Windsurf using this MCP Server without breaking your flow.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Ellie Planner MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Auto-generate task breakdowns in Windsurf

The `create_task` tool lets Cascade build out your project structure before you write a single line of code. You hand the agent a high-level goal. It reads your workspace context and generates the necessary tickets automatically. It goes further than simple creation. Since Cascade chains actions, the agent assigns categories using `list_labels` and organizes everything into the right buckets via `list_lists`. You get a populated sprint board in seconds.

Pull live project context

The `list_tasks` operation pulls your active to-do list straight into the editor. Cascade checks what needs doing today. It then reads the specific requirements using `get_task` to understand the exact acceptance criteria. This means your agent always has the latest project state. It knows what you finished yesterday and what blocks you right now. You skip the browser tab switch entirely.

Close out work via MCP Server

The `complete_task` tool fires the moment your code passes tests. Cascade finishes a feature, verifies the build, and marks the ticket done. You stay focused on the next hard problem. If requirements change, it can clean up the board using `delete_task` or adjust timelines with `update_task`. The agent handles the administrative overhead. You just write code.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "ellie-planner-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 Ellie Planner. 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 Ellie Planner 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 Ellie Planner MCP in Windsurf

Open the MCP Servers UI under Settings, then Cascade. Add the server details to your configuration and hit the refresh button in the panel.

Yes. Cascade uses `create_task` multiple times in a single run to break large features into smaller tickets. It maps out the entire sequence automatically via the MCP integration.

No. The agent reads your current structure using `list_lists` first. It appends new items rather than destroying your existing organization.

Cascade handles that natively. Once you give it a goal, it sequences the operations and updates statuses in the background as it completes the work.

This MCP Server only accesses your task titles, labels, and list IDs. Vinkius runs the connection through an isolated V8 sandbox. Tokens are ephemeral, meaning your project data never leaks into training sets.

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