How to Use the Todoist MCP in Windsurf

Q: Can Windsurf manage my overdue tasks?

Yes. The agent can run listactivetasks to check for items past their due date. If a task is completed but shouldn't be, it can use the reopentask tool to mark it as active again.

Q: Where can I check the status of a task using Todoist and Windsurf?

You tell Windsurf to check a specific item. It uses gettaskdetails which returns the current completion status, associated project, and any recent comments.

Get your whole life organized with Windsurf's autonomous task management.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Todoist MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Schedule Tasks Using the Todoist MCP Server

Windsurf uses this server to handle complex scheduling goals. You just tell it, 'Finish Project Alpha tasks and start the next quarter.' The agent figures out the steps: first, it runs `list_projects` to confirm the project ID. Then, it autonomously calls `create_task` for the new item, followed by `update_task_details` to set due dates across multiple items. It doesn't stop there. If a task is already done but needs revisiting, it can use `reopen_task`. This whole process runs in the background without you having to prompt each step.

Reviewing Project Status with MCP Server

Need an overview of what's going on? The agent pulls project metadata using `get_project_details` and gets a list of all available projects via `list_projects`. You can then drill down to see sections inside any given project by calling `list_project_sections`. This gives you the full picture before writing code. It also lets you check what specific tasks are active or pending using `list_active_tasks`, filtering them by label if needed.

Handling Task Communications

The server manages task context, which is critical for team collaboration. You can pull all comments associated with a project or specific tasks using `list_comments`. This means your agent keeps track of the entire history. Furthermore, it knows how to check all available labels across your account via `list_all_labels` and even modify task details directly through `update_task_details`, making sure everyone's on the same page.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "todoist-extended-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 Todoist. 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 Todoist 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 Todoist MCP in Windsurf

Windsurf connects via an MCP endpoint, treating your Todoist account like any other data source. When you set a goal, the agent reads the context from both sources and determines how to execute it against Todoist's available tools.

Yes. The agent can run `list_active_tasks` to check for items past their due date. If a task is completed but shouldn't be, it can use the `reopen_task` tool to mark it as active again.

The server primarily handles project metadata and individual task details. This includes task descriptions, completion status, associated labels, and comments attached to the items.

No. The MCP Server only reads and writes data within your existing Todoist account structure; it doesn't manage or alter any billing information.

You tell Windsurf to check a specific item. It uses `get_task_details` which returns the current completion status, associated project, and any recent comments.

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