Skip to main content
Glama
Todoist MCP Server

Todoist MCP Server

by abhiz123

Todoist MCP 服务器

铁匠徽章

一个 MCP(模型上下文协议)服务器实现,将 Claude 与 Todoist 集成,实现自然语言任务管理。此服务器允许 Claude 使用日常语言与您的 Todoist 任务进行交互。

特征

  • 自然语言任务管理:使用日常语言创建、更新、完成和删除任务

  • 智能任务搜索:使用部分名称匹配查找任务

  • 灵活过滤:按截止日期、优先级和其他属性过滤任务

  • 丰富的任务详情:支持描述、截止日期和优先级

  • 直观的错误处理:清晰的反馈以获得更好的用户体验

Related MCP server: Enhanced Todoist MCP Server Extended

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Todoist MCP 服务器:

npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude

手动安装

npm install -g @abhiz123/todoist-mcp-server

工具

todoist_create_task

创建具有各种属性的新任务:

  • 必填:内容(任务标题)

  • 可选:描述、截止日期、优先级(1-4)

  • 示例:“创建任务‘团队会议’,描述为‘每周同步’,明天截止”

todoist_get_tasks

检索和过滤任务:

  • 按截止日期、优先级或项目进行过滤

  • 自然语言日期过滤

  • 可选结果限制

  • 例如:“显示本周截止的高优先级任务”

todoist_update_task

使用自然语言搜索更新现有任务:

  • 通过部分名称匹配查找任务

  • 更新任何任务属性(内容、描述、截止日期、优先级)

  • 例如:“更新下周一截止的会议任务”

todoist_complete_task

使用自然语言搜索将任务标记为完成:

  • 通过部分名称匹配查找任务

  • 确认完成状态

  • 例如:“将文档任务标记为完成”

todoist_delete_task

使用自然语言搜索删除任务:

  • 按名称查找和删除任务

  • 确认消息

  • 示例:“删除 PR 审核任务”

设置

获取 Todoist API 令牌

  1. 登录您的 Todoist 帐户

  2. 导航至“设置”→“集成”

  3. 在“开发者”下找到您的 API 令牌

与 Claude Desktop 一起使用

添加到您的claude_desktop_config.json :

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["-y", "@abhiz123/todoist-mcp-server"],
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

示例用法

创建任务

"Create task 'Team Meeting'"
"Add task 'Review PR' due tomorrow at 2pm"
"Create high priority task 'Fix bug' with description 'Critical performance issue'"

获取任务

"Show all my tasks"
"List tasks due today"
"Get high priority tasks"
"Show tasks due this week"

更新任务

"Update documentation task to be due next week"
"Change priority of bug fix task to urgent"
"Add description to team meeting task"

完成任务

"Mark the PR review task as complete"
"Complete the documentation task"

删除任务

"Delete the PR review task"
"Remove meeting prep task"

发展

从源代码构建

# Clone the repository
git clone https://github.com/abhiz123/todoist-mcp-server.git

# Navigate to directory
cd todoist-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

贡献

欢迎贡献代码!欢迎提交 Pull 请求。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅LICENSE文件。

问题与支持

如果您遇到任何问题或需要支持,请在GitHub 存储库上提交问题。

Available Tools

5 tools
todoist_complete_taskB

Mark a task as complete by searching for it by name

Inputs: task_name (required).

todoist_create_taskB

Create a new task in Todoist with optional description, due date, and priority

Inputs: content (required), priority, due_string, description.

todoist_delete_taskB

Delete a task from Todoist by searching for it by name

Inputs: task_name (required).

todoist_get_tasksA

Get a list of tasks from Todoist with various filters

Inputs: limit, filter, priority, project_id.

todoist_update_taskB

Update an existing task in Todoist by searching for it by name and then updating it

Inputs: task_name (required), content, priority, due_string, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct operation (create, read, update, delete, complete) on tasks, with no overlap. The descriptions clearly differentiate the actions.

    Naming Consistency5/5

    All tools follow a consistent 'todoist_verb_task' pattern (e.g., todoist_complete_task, todoist_create_task), using snake_case and clear verbs.

    Tool Count5/5

    With 5 tools, the set covers the essential CRUD operations plus a completion action, which is appropriate for a task management server. No excessive or missing tools.

    Completeness4/5

    The tools cover full CRUD (create, get, update, delete) and a common operation (complete), which is sufficient for basic task management. Minor gaps like reordering or sharing tasks are not critical.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers