Todoist MCP

这是一个用于与Todoist API交互的模型上下文协议（MCP）服务器，提供了一种结构化的方式来管理你的Todoist任务、项目、部分和标签。只需用自然语言与你的AI代理交谈，它会访问MCP服务器并为你完成任务。

功能

• 任务管理：创建、读取、更新和删除任务
• 项目组织：管理项目及其层次结构
• 部分：使用部分在项目中组织任务
• 标签：创建和管理任务标签
• 截止日期：使用自然语言处理设置和管理截止日期
• 使用Python MCP SDK进行MCP服务器操作，并集成Todoist SDK来执行上述任务。

预备条件

• Python 3.13或更高版本
• uv 用于依赖管理
• Todoist API令牌（从Todoist 集成获取）

安装

1. 克隆仓库：

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

2. 安装开发依赖项：

   uv sync
   

配置

Windsurf

前往 /home/<user>/.codeium/windsurf/mcp_config.json 并添加以下内容：

{
    "mcpServers": {
        "todoist-mcp": {
            "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER",
                "run",
                "server.py"
            ],
            "env": {
                "TODOIST_API_TOKEN": "your_api_token_here"
            }
        }
    }
}

示例

{
    "mcpServers": {
        "todoist-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/home/trickster026/todoist-mcp/src/",
                "run",
                "server.py"
            ],
            "env": {
                "TODOIST_API_TOKEN": "your_api_token_here"
            }
        }
    }
}

许可证

本项目采用MIT许可证——详情见LICENSE文件。

致谢

• Todoist API
• uv

未来工作

• 重构代码
• 文档增强 —— 添加更多示例和更好的文档。
• 添加其他AI代理设置步骤