How to Use the Todoist MCP in Claude Code

Q: How do I list tasks in Todoist using Claude Code?

Run listtasks directly from the terminal. You can pipe that output into other scripts for immediate processing, making it part of your existing shell workflow.

Q: Can I automate task creation in Todoist using Claude Code?

Absolutely. Use createtask within a script. By running this command in a CI/CD pipeline, you ensure that every build or deployment automatically records the required tasks.

Q: If I need to check task statuses on Todoist with Claude Code, what’s the process?

You run listtasks and look for the status indicators. If a task is done, you can then use completetask in a subsequent command to mark it as finished.

Q: What labels does the Todoist MCP Server support listing with Claude Code?

To see all tags available for scripting purposes, run the listlabels tool. The output provides a clean, machine-readable list of every user-defined label.

Manage Todoist tasks from your terminal using Claude Code.

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 Claude Code

Create your Vinkius account to connect Todoist to Claude Code 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 Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Schedule Task Creation in Todoist

You can pipe the output of a script directly into `create_task` to automate task entry. This is ideal for cron jobs or CI/CD pipelines that need to record progress. Run it headless: set up a shell script that calls the tool, and your tasks get created without needing a GUI.

Batch Task Reporting from Todoist

Need a quick report of all active items? Execute `list_tasks` via the terminal. You can filter by project ID in the command line, getting only the data you need for your script's input. This makes it perfect for generating audit logs or nightly status reports from deep within the shell.

Audit Project Structure in Todoist

Use `list_projects` first to get a list of all available containers. Then, chain that output into `list_sections` to map out the full project hierarchy via the command line. It lets you script complex directory listings and structural checks across your entire todo environment.

Setup guide

Set up Todoist MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see todoist-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Todoist transactions." It will automatically discover and invoke the available Todoist tools.

Terminal

claude mcp add --transport http todoist-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
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

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "todoist-mcp": {
      "type": "url",
      "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 Claude Code

Run `list_tasks` directly from the terminal. You can pipe that output into other scripts for immediate processing, making it part of your existing shell workflow.

Absolutely. Use `create_task` within a script. By running this command in a CI/CD pipeline, you ensure that every build or deployment automatically records the required tasks.

You run `list_tasks` and look for the status indicators. If a task is done, you can then use `complete_task` in a subsequent command to mark it as finished.

To see all tags available for scripting purposes, run the `list_labels` tool. The output provides a clean, machine-readable list of every user-defined label.

This MCP Server handles task content and project IDs. When using it in scripts, you're dealing exclusively with structured identifiers passed through standard output streams.

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