RTM MCP Server

RTM MCP服务器

A生产质量 模型上下文协议 （MCP）服务器 澳大利亚 任务管理。

使Claude能够通过自然语言对话管理您的任务。

特性

• RTM API全面覆盖：30多种工具，涵盖任务、列表、标签、笔记等
• 智能添加语法：自然语言任务创建("Call mom ^tomorrow !1 #family")
• 撤消支持：所有写入操作都返回用于撤消的事务ID
• 异步性能：基于httpx构建，带有连接池
• 类型安全：完整的Pydantic模型和类型提示

安装

使用uvx（推荐）

uvx rtm-mcp

使用pip

pip install rtm-mcp

源自源头

git clone https://github.com/ljadach/rtm-mcp.git
cd rtm-mcp
uv sync

设置

1.获取RTM API证书

RTM API密钥是通过单独的开发人员门户发布的（而不是您的帐户设置）：

1. 首选 RTM API密钥注册 --您可能需要先登录
2. 点击 “申请API密钥”
3. 填写表格——应用程序名称（例如“Claude MCP”）、描述、任何有效信息
4. 提交后，您将看到您的 API密钥 和 共享的秘密 --保存两者

2.运行安装程序

rtm-setup

这将：

• 提示输入API凭据
• 打开浏览器进行授权
• 将身份验证令牌保存到 ~/.config/rtm-mcp/config.json

3.配置克劳德桌面

添加 ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "rtm": {
      "command": "uvx",
      "args": ["rtm-mcp"]
    }
  }
}

用法

配置后，您可以让Claude管理您的任务：

• *“显示我今天到期的任务”*
• *“添加明天购买杂货的任务，优先级高”*
• *“完成杂货任务”*
• *“我有哪些高优先级的任务？”*
• *“将会议准备任务移至我的工作列表”*
• *“向项目任务添加注释”*

智能添加语法

添加任务时，使用RTM的Smart Add语法：

例子： "Review report ^friday !1 #work =1h *weekly"

可用工具

任务

• list_tasks -使用筛选器列出任务
• add_task -创建新任务
• complete_task / uncomplete_task -标记已完成或重新打开
• delete_task -删除任务
• postpone_task -将到期日提前一天
• move_task -移动到其他列表
• set_task_name -重命名任务
• set_task_due_date -更改到期日
• set_task_priority -设置优先级
• set_task_recurrence -设置重复模式
• set_task_start_date -设置开始日期
• set_task_estimate -设置时间估计
• set_task_url -附加URL
• add_task_tags / remove_task_tags -管理标签

备注

• add_note -向任务添加注释
• edit_note -编辑现有注释
• delete_note -删除注释
• get_task_notes -查看所有笔记

列表

• get_lists -列出所有列表
• add_list -创建新列表
• rename_list -重命名列表
• delete_list -删除列表
• archive_list / unarchive_list -档案管理
• set_default_list -设置默认列表

公用事业

• test_connection -测试API连接
• check_auth -验证身份验证
• get_tags -列出所有标签
• get_locations -列出已保存的位置
• get_settings -查看用户设置
• get_contacts / get_groups -联系人管理
• parse_time -解析自然语言时间
• undo -撤消以前的操作

配置

环境变量

RTM_API_KEY=your_api_key
RTM_SHARED_SECRET=your_shared_secret
RTM_AUTH_TOKEN=your_token

配置文件

~/.config/rtm-mcp/config.json:

{
  "api_key": "your_api_key",
  "shared_secret": "your_shared_secret",
  "token": "your_token"
}

发展

# Install dev dependencies
make dev

# Run linting
make lint

# Run tests
make test

# Run with coverage
make test/coverage

# Format code
make format

码头工人

docker build -t rtm-mcp .
docker run -it --rm \
  -e RTM_API_KEY \
  -e RTM_SHARED_SECRET \
  -e RTM_AUTH_TOKEN \
  rtm-mcp

Docker的Claude桌面配置：

{
  "mcpServers": {
    "rtm": {
      "command": "docker",
      "args": ["run", "-i", "--rm",
        "-e", "RTM_API_KEY",
        "-e", "RTM_SHARED_SECRET",
        "-e", "RTM_AUTH_TOKEN",
        "rtm-mcp"]
    }
  }
}

许可证

MIT许可证-请参阅 许可证 了解详情。

致谢

• 澳大利亚 卓越的任务管理服务
• FastMCP 对于MCP框架
• Anthropic 用于Claude和MCP规范