How to add Todoist MCP Server (community, abhiz123) to Windsurf

Lightweight community Todoist server for natural-language task create, update, and search. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 393★ · stdio · apikey

Windsurf config for Todoist MCP Server (community, abhiz123)

npx -y @abhiz123/todoist-mcp-server

{
  "mcpServers": {
    "todoist-mcp-server-community-abhiz123": {
      "command": "npx",
      "args": [
        "-y",
        "@abhiz123/todoist-mcp-server"
      ],
      "env": {
        "TODOIST_API_TOKEN": "<your-todoist-api-token>"
      }
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Todoist MCP Server (community, abhiz123) config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Todoist MCP Server (community, abhiz123)'s tools become available to Cascade.

Before you start

Node.js installed (used to run via npx / global install)
A Todoist account
A Todoist API token from Todoist → Settings → Integrations → Developer, set as the TODOIST_API_TOKEN environment variable

What Todoist MCP Server (community, abhiz123) can do in Windsurf

todoist_create_task

Create a task with content and optional description, due date (natural language), and priority (1-4).

todoist_get_tasks

Retrieve and filter tasks by due date, priority, or project, with optional result limits.

todoist_update_task

Update a task's content, description, due date, or priority, locating it by natural-language name search.

todoist_complete_task

Mark a task complete, located by natural-language partial-name match.

todoist_delete_task

Delete a task, located by natural-language partial-name match.

Security

The TODOIST_API_TOKEN has full access to your Todoist account, so keep it in env vars only. This is a community project that is less actively maintained than Doist's official server.

Todoist MCP Server (community, abhiz123) + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Todoist MCP Server (community, abhiz123) config there under the "mcpServers" key and restart the client.

Is Todoist MCP Server (community, abhiz123) safe to use with Windsurf?

The TODOIST_API_TOKEN has full access to your Todoist account, so keep it in env vars only. This is a community project that is less actively maintained than Doist's official server.

How do I authenticate?

Set the TODOIST_API_TOKEN environment variable to a token from Todoist Settings → Integrations → Developer. There is no OAuth flow.

Do I need to know task IDs to update or complete tasks?

No. The update, complete, and delete tools find tasks by partial-name (natural-language) match, so you can refer to tasks by description.

Is this the official Todoist server?

No — it's a community project by abhiz123. Doist publishes the official one under the @doist scope.

View repo Full Todoist MCP Server (community, abhiz123) page