Todoist MCP Server Df760729

MCP运维云端

提供方 gekitsuu

运维云端 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaude
查看接入方式

一个将Todoist任务管理与Claude集成的MCP服务器,支持通过对话管理任务,适用于高压力工作环境、批量任务操作和ADHD友好的任务管理。

一句话选型结论

按资料字段整理

Todoist MCP Server Df760729 属于运维云端类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 6 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量6暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

任务管理Python本地部署对话式界面批量操作ADHD友好集成服务

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
python -m venv venv

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 6 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 6 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Todoist MCP Server Df760729当前 6 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方gekitsuu上游标注的维护方 gekitsuu
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

6.3 KB
来自项目仓库与上游目录的原文,未做删改

Todoist MCP Server

A Model Context Protocol (MCP) server that integrates Todoist task management with Claude. Manage your Todoist tasks conversationally without context-switching!

Features

  • Get Tasks: Fetch and filter tasks by project, label, or custom filters
  • Create Tasks: Add new tasks with priorities, due dates, and labels
  • Update Tasks: Modify existing tasks, change priorities, defer dates
  • Complete Tasks: Mark tasks as done
  • List Projects: View all your Todoist projects
  • List Labels: View all your Todoist labels

Perfect for:
- Managing tasks during high-stress work periods
- Bulk task operations (defer, prioritize, organize)
- Quick task triage without leaving your conversation with Claude
- ADHD-friendly task management with conversational interface

Prerequisites

  • Python 3.10 or higher
  • A Todoist account
  • Todoist API token (get it here)

Installation

1. Clone the repository```bash

git clone https://github.com/yourusername/todoist-mcp-server.git
cd todoist-mcp-server


### 2. Create a virtual environment (recommended)```bash
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install the package```bash

pip install -e .


### 4. Configure your API token

Create a `.env` file in the project root:```bash
cp .env.example .env

Edit .env and add your Todoist API token:```
TODOIST_API_TOKEN=your_actual_token_here


Get your token from: https://todoist.com/app/settings/integrations/developer

## Configuration for Claude Code

### Option 1: Configure in Claude Desktop (Recommended)

Add this to your Claude Desktop configuration file:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json````json
{
  "mcpServers": {
    "todoist": {
      "command": "python",
      "args": ["-m", "todoist_mcp.server"],
      "env": {
        "TODOIST_API_TOKEN": "your_token_here"
      }
    }
  }
}

Option 2: Use with Claude Code CLI

If using with claude-code CLI:```bash

Set environment variable

export TODOIST_API_TOKEN=your_token_here

Run the server

python -m todoist_mcp.server


Or configure in your MCP settings file for Claude Code.

### Restart Claude

After configuration, restart Claude Desktop or Claude Code to load the MCP server.

## Usage Examples

Once configured, you can interact with Todoist through natural conversation with Claude:

### View Today's Tasks```
You: "Show me my tasks for today"

Claude will use todoist_get_tasks with filter="today"

Create a Task```

You: "Create a task to review the infrastructure PR, priority 4, due tomorrow"

Claude will use todoist_create_task with appropriate parameters


### Bulk Defer Tasks```
You: "I'm overwhelmed. Show me all my tasks for today, then defer everything
      except priority 4 items to next week"

Claude will:
1. Use todoist_get_tasks to see today's tasks
2. Use todoist_update_task to defer non-urgent items

Organize by Project```

You: "Show me my projects, then move all high-priority tasks to the 'Sprint' project"

Claude will:
1. Use todoist_get_projects to list projects
2. Use todoist_update_task to move tasks


### Complete Tasks```
You: "I just finished the deployment. Mark that task as complete"

Claude will use todoist_complete_task

Available Tools

todoist_get_tasks

Fetch tasks with optional filters.

Parameters:
- project_id (optional): Filter by project ID
- label (optional): Filter by label name
- filter (optional): Todoist filter query (e.g., "today", "overdue", "priority 1")

todoist_create_task

Create a new task.

Parameters:
- content (required): Task title/content
- description (optional): Task description
- project_id (optional): Project to add task to
- priority (optional): 1-4 (4 is highest)
- due_string (optional): Human-readable due date ("tomorrow", "next Monday", etc.)
- labels (optional): Array of label names

todoist_update_task

Update an existing task.

Parameters:
- task_id (required): ID of task to update
- content (optional): New task content
- description (optional): New description
- priority (optional): New priority (1-4)
- due_string (optional): New due date
- labels (optional): New labels array (replaces existing)

todoist_complete_task

Mark a task as complete.

Parameters:
- task_id (required): ID of task to complete

todoist_get_projects

List all projects (no parameters required).

todoist_get_labels

List all labels (no parameters required).

Troubleshooting

"TODOIST_API_TOKEN not set" error

  • Make sure you've created a .env file with your token
  • Or set the environment variable in your shell/Claude config
  • Get your token from: https://todoist.com/app/settings/integrations/developer

Server not appearing in Claude

  • Check that your claude_desktop_config.json syntax is correct
  • Restart Claude Desktop completely
  • Check Claude's logs for MCP connection errors

API errors

  • Verify your token is valid and hasn't expired
  • Check your internet connection
  • Some operations require Todoist Premium (like labels)

Development

Running tests```bash

pip install -e ".[dev]"
pytest


### Code formatting```bash
black src/
ruff check src/

Contributing

Contributions welcome! Please:
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

License

MIT License - see LICENSE file for details.

Acknowledgments

  • Built with the Model Context Protocol
  • Uses the Todoist API
  • Created for better ADHD-friendly task management

Links

  • MCP Documentation
  • Todoist API Documentation
  • Get Todoist API Token

Support

For issues and feature requests, please open an issue.

Testing

The project includes a comprehensive test suite to ensure reliability.

Running Tests```bash

Install test dependencies

pip install pytest pytest-asyncio

Run all tests

PYTHONPATH=src pytest tests/ -v
```

Test Coverage

The test suite includes:

  • API Method Validation: Ensures we're calling valid Todoist API methods (would have caught the close_task vs complete_task bug)
  • Handler Function Tests: Unit tests for all MCP handlers with mocked API calls
  • Error Handling Tests: Validates proper error handling and user-friendly messages

See tests/README.md for more details.

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Todoist MCP Server Df760729 怎么安装?

在客户端按下面的安装命令接入:python -m venv venv。装完在客户端配置里引用同一个包或端点。

Todoist MCP Server Df760729 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Todoist MCP Server Df760729 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Todoist MCP Server Df760729 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Todoist MCP Server Df760729 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Todoist MCP Server Df760729 能提供哪些能力?

资料显示约 6 个工具;能力标签包括 集成服务、Python、Claude、批量操作。具体工具清单以官方文档为准。

Todoist MCP Server Df760729 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Todoist MCP Server Df760729 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。