Todoist任务管理协议

一个用于与Todoist API交互的模型上下文协议服务器,提供结构化方式来编程管理Todoist任务、项目、部分和标签。

  • by trickster026
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 trickster026/todoist-mcp

使用说明

真正的MCP

一个模型上下文协议(MCP)服务器,用于与Todoist的API交互,提供一种结构化的方式以编程方式管理Todoist任务、项目、部分和标签。只需在与您的AI代理交谈时使用自然语言,它就会访问MCP服务器并为您完成任务。

特性

  • 任务管理:创建、读取、更新和删除任务
  • 项目组织机构:管理项目及其层次结构
  • 章节:使用章节组织项目内的任务
  • 标签:创建和管理任务标签
  • 到期日:使用自然语言处理设置和管理截止日期
  • 为MCP服务器使用Python MCP SDK,并为上述所有任务集成Todoist SDK。

先决条件

安装

  1. 克隆存储库:

    git clone https://github.com/trickster026/todoist-mcp.git
    cd todoist-mcp
    
  2. 安装开发依赖项:

    uv sync
    

配置

帆板运动

首选 /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许可证获得许可-请参阅 许可证 文件以获取详细信息。

致谢

未来工作

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