Connector guide2-minute read12 MCP toolsEnglish · Deutsch · Italiano

如何将 Todoist 连接到 Gemini — 通过 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.

💡 无需安装? 直接使用 cloud.anythingmcp.com 登录、点击 Connectors → Todoist、粘贴凭证、生成 MCP API key — 完成。无 Docker、无 git clone、无本地服务器。

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.

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

TODOIST_API_TOKEN

步骤 1 — 获取凭证

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)

步骤 2 — 安装 adapter

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

步骤 3 — 在 Gemini 中添加连接器

Gemini CLI 从 ~/.gemini/settings.json (Windows: %APPDATA%\gemini\settings.json) 读取 MCP 服务器。添加:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_API_KEY" }
    }
  }
}
  1. 从 AnythingMCP 获取你的 MCP API key
  2. 保存文件并重启 gemini
  3. 在 Gemini CLI 中运行 /mcpTodoist 应显示为可用。
  4. Vertex AI Studio: 将 https://cloud.anythingmcp.com/mcp 传入请求的 tools 数组,使用相同的 Bearer 头。

可用工具

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

Gemini 1.5 Pro 或 2.x 支持 MCP 吗? 支持 — Gemini CLI ≥ 0.4 与 Vertex AI tools API 均接受带 Bearer 头的 MCP httpUrl 连接器。

下一步

这份指南对您有帮助吗?

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.

相关指南