# Todoist MCP

> Todoist's own MCP server: your agent finds, adds, completes and reschedules your tasks and organizes your projects from the chat.

Todoist's own hosted MCP server lets your agent read and manage your Todoist tasks and projects without leaving the chat. Ask what's overdue, capture new tasks, shape a project or tidy your Inbox in plain words.

What you can do with it
- Find tasks by date, project, label, saved filter or text, including what's overdue
- Add, update, complete and reschedule tasks, including recurring ones
- Create and reorganize projects and sections, and move tasks between them
- Add comments, labels, reminders and saved filters
- Read your activity log to see what got done, and check project health and productivity stats

How it connects
Todoist hosts it at https://ai.todoist.net/mcp. Your agent connects with OAuth: you sign in to Todoist and approve read and write access, and your password is never shared with the agent. You can review or revoke that access any time in Todoist under Settings > Integrations. Todoist has setup guides for ChatGPT, Claude, Claude Code, Codex and more.

Good to know
- It can read and change your Todoist data, so most agents ask you to confirm before each change.
- Ask it to reschedule a recurring task rather than change its date, so the repeat schedule is kept.
- Work or school accounts may need an admin to allow third-party connections.
- How much activity history it can read depends on your Todoist plan.

- Type: Plugin
- Made by: Todoist
- Category: Productivity
- Formats: Remote MCP
- Version: 1.0.0
- Website: https://www.todoist.com/help/todoist/todoist-and-ai/connect-todoist-to-an-ai-assistant-xMSzFfHng
- Source: https://github.com/Doist/todoist-mcp
- Page: https://pluginboard.ai/plugins/todoist-mcp

## Works with

- ChatGPT
- Claude
- Muse
- Grok Bot
- Gemini
- Grok
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### ChatGPT

In ChatGPT on the web: Plugins → + → Add custom MCP server, then paste https://ai.todoist.net/mcp under Connection. Business and Enterprise plans; Pro can add read-only servers.

### Claude

In Claude (web or desktop): Customize → Connectors → Add custom connector, then paste https://ai.todoist.net/mcp

### Muse

In Muse: In a Muse chat, ask it to create a custom connector for the MCP server at https://ai.todoist.net/mcp. Then tap Connect on the card it shows and sign in, or add your key.

### Grok Bot

In Grok Bot: In a chat with your Bot, say "Add this MCP server: https://ai.todoist.net/mcp". It confirms the details with you and sets it up, and the tools are ready from your next message.

### Gemini

In Gemini: At gemini.google.com: Settings → Connected Apps → Add a custom app, then paste https://ai.todoist.net/mcp

### Grok

In Grok on the web: At grok.com/connectors: New Connector → Custom, then enter https://ai.todoist.net/mcp and sign in if it asks.

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22todoist-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fai.todoist.net%2Fmcp%22%7D

Copilot CLI:

```shell
copilot mcp add --transport http todoist-mcp https://ai.todoist.net/mcp
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=todoist-mcp&config=eyJ1cmwiOiJodHRwczovL2FpLnRvZG9pc3QubmV0L21jcCJ9

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "todoist-mcp": {
      "url": "https://ai.todoist.net/mcp"
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add --transport http todoist-mcp https://ai.todoist.net/mcp
```

### Codex

Run in your terminal:

```shell
codex mcp add todoist-mcp --url https://ai.todoist.net/mcp
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "todoist-mcp": {
      "url": "https://ai.todoist.net/mcp"
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add --transport http todoist-mcp https://ai.todoist.net/mcp
```

### Replit

In Replit: At replit.com/integrations, open MCP Servers → + Add MCP server, paste https://ai.todoist.net/mcp (add any headers under Advanced settings), then click Test & save.

### OpenClaw

Run in your terminal:

```shell
openclaw mcp add todoist-mcp --url https://ai.todoist.net/mcp --transport streamable-http
```

If it needs a key or sign-in: For https://ai.todoist.net/mcp, add --header NAME=value for each header it needs, or --auth oauth and then run openclaw mcp login todoist-mcp.

### OpenCode

Run in your terminal:

```shell
opencode mcp add todoist-mcp --url https://ai.todoist.net/mcp
```

If it needs a key: For https://ai.todoist.net/mcp, add --header 'NAME=value' for each header it needs. Add --global to use it in every project.

### Hermes Agent

Run in your terminal:

```shell
hermes mcp add todoist-mcp --url https://ai.todoist.net/mcp
```

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "todoist-mcp": {
      "url": "https://ai.todoist.net/mcp"
    }
  }
}
```

If it signs in with OAuth: If https://ai.todoist.net/mcp asks you to sign in, add --auth oauth to the command, or auth: oauth to its entry.

---
From Pluginboard (https://pluginboard.ai).