Connector guide2-minute read12 MCP toolsEnglish · Deutsch · Italiano

How to Connect Todoist to Gemini — via MCP

Drive Todoist (personal/team task manager) from any AI agent: projects, tasks, comments, labels, sections. 12 tools, Bearer token auth, REST API v2.

HCBy HelpCode teamUpdated 2 min read Open source on GitHub

No credit card · 7-day trial · Self-host alternative available

Todoist

MCP connector

Todoist

Drive Todoist (personal/team task manager) from any AI agent: projects, tasks, comments, labels, sections. 12 tools, Bearer token auth, REST API v2.

Tools

12

Region

INTL

Category

project-management

Authentication

Bearer Token

Required env vars

TODOIST_API_TOKEN
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Source-available BSL-1.1
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

No install? Use cloud.anythingmcp.com directly.

Sign in, install the Todoist in one click, paste the credentials, mint an MCP API key — done. No Docker, no git clone, no local server to run.

Open Cloud

TL;DR

Drive Todoist (personal/team task manager) from any AI agent: projects, tasks, comments, labels, sections. 12 tools, Bearer token auth, REST API v2.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Todoist, paste your credentials, mint an MCP API key — done. No Docker, no git clone, no local server.

Todoist + Gemini

Drive Todoist (personal/team task manager) from any AI agent: projects, tasks, comments, labels, sections. 12 tools, Bearer token auth, REST API v2.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

TODOIST_API_TOKEN

Step 1 — Get credentials

Setup:

  1. Sign in to https://todoist.com → top-right avatar → Settings → Integrations → Developer → API token → Copy.
  2. Set TODOIST_API_TOKEN to it.

Authentication: Authorization: Bearer ${TODOIST_API_TOKEN}. The token is per-user; everything done with it appears as that user's actions. Personal API tokens never expire.

Hierarchy: Project → Section (optional) → Task → Sub-task. Tasks can also live directly in a project without a section. The Inbox is a special project (inbox_project=true).

…(continued in the in-app connector instructions)

Step 2 — Install the adapter

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d

Step 3 — Add the connector in Gemini

Gemini CLI reads MCP servers from ~/.gemini/settings.json (or %APPDATA%\gemini\settings.json on Windows). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_API_KEY" }
    }
  }
}
  1. Get your MCP API key from AnythingMCP → Profile → MCP API Keys → New Key.
  2. Save the file and restart gemini.
  3. Run /mcp inside the Gemini CLI — Todoist should be listed as available.
  4. Vertex AI Studio: pass https://cloud.anythingmcp.com/mcp to the tools array of your request with the same Bearer header.

Available tools

ToolWhat it does
todoist_get_projectsList all projects the user can access
todoist_create_projectCreate a new project
todoist_get_active_tasksList active (non-completed) tasks with filters
todoist_get_taskFetch a single task by ID
todoist_create_taskCreate a task
todoist_update_taskUpdate a task
todoist_complete_taskMark a task as completed
todoist_reopen_taskReopen a previously-completed task
todoist_delete_taskPermanently delete a task
todoist_get_commentsList comments on a project OR a task
todoist_create_commentAdd a comment to a project or task
todoist_get_labelsList the user's personal labels

FAQ

Does Gemini 1.5 Pro or 2.x support MCP? Yes — Gemini CLI ≥ 0.4 and Vertex AI tools API both accept MCP httpUrl connectors with Bearer headers.

Next steps

Was this guide helpful?

Ready to ship

Your Todoist agent is one click away.

Install the connector, paste the key, prompt Gemini. Free for 7 days, no credit card.

Related guides