Todoist
The Todoist connector lets AI agents manage your tasks and projects — from listing and searching tasks to creating new ones, updating due dates and priorities, completing tasks, and organising work into projects. All operations go through the Todoist REST API using OAuth 2.0, with credentials stored encrypted in MCPGate's vault.
Required scopes#
MCPGate requests the following OAuth scopes when you connect a Todoist account.
| Scope | Purpose |
|---|---|
| data:read | Read projects, tasks, and labels |
| data:read_write | Create, update, complete, and delete tasks and projects |
Tool reference#
The Todoist connector exposes 10 tools: 5 read, 4 write, and 1 delete. Use the MCP Apps page to enable or disable individual tools per app, and the Guardrails page to add fine-grained rules on top.
| Tool | Category | Description |
|---|---|---|
| todoist_list_projects | read | List all Todoist projects |
| todoist_get_project | read | Get a specific Todoist project by ID |
| todoist_list_tasks | read | List tasks, optionally filtered by project |
| todoist_get_task | read | Get a specific task by ID |
| todoist_list_labels | read | List all personal labels |
| todoist_create_project | write | Create a new Todoist project |
| todoist_create_task | write | Create a new task in Todoist |
| todoist_update_task | write | Update an existing task |
| todoist_complete_task | write | Mark a task as complete |
| todoist_delete_task | delete | Delete a task permanently |
Delete is permanent
todoist_delete_task permanently removes the task — it does not move it to a trash or archive. Use todoist_complete_task to close tasks reversibly.Common guardrail recipes#
Read-only access#
Enable only the five read tools and deny all write and delete tools. Use this for agents that report on task status, generate daily summaries, or feed Todoist data into other workflows without making any changes.
Contribute preset#
Enable read tools plus todoist_create_task, todoist_update_task, and todoist_complete_task. Deny todoist_create_project and todoist_delete_task. This lets the agent manage tasks within existing projects without creating new top-level projects or permanently deleting work.
Restrict to a specific project#
Apply the allow_values template to all write tools, targeting the project_id field. Provide the ID of the project(s) the agent is permitted to write to, keeping it isolated from other projects in the account.
Troubleshooting#
- Task not found after creation — Todoist syncs are eventually consistent. If you create a task and immediately list tasks, the new task may not appear until the next sync cycle. Wait a moment and retry
todoist_list_tasks. - Due date not parsed correctly — Todoist accepts due dates as natural language strings (e.g.
tomorrow,next Monday) or ISO 8601 dates. Ensure the AI is providing a valid format. - Label not found —
todoist_list_labelsreturns personal labels only. Shared labels created in team workspaces are not accessible via the REST API.