Rtm MCP

🚀 RTM MCP 服務器

RTM MCP 服務器是一個具備生產質量的 模型上下文協議（MCP）服務器，專為 Remember The Milk 任務管理系統打造。它能讓 Claude 通過自然語言對話來管理你的任務，極大提升任務管理的便捷性和效率。

🚀 快速開始

在使用 RTM 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. 配置 Claude 桌面應用

在 ~/.config/claude/claude_desktop_config.json 文件中添加以下內容：

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

使用方法

配置完成後，你可以向 Claude 發出以下指令來管理任務：

• "Show my tasks due today"（顯示今天到期的任務）
• "Add a task to buy groceries tomorrow, high priority"（添加一個明天購買食品雜貨的高優先級任務）
• "Complete the grocery task"（完成購買食品雜貨的任務）
• "What high priority tasks do I have?"（我有哪些高優先級任務？）
• "Move the meeting prep task to my Work list"（將會議準備任務移動到我的工作列表中）
• "Add a note to the project task"（為項目任務添加一條筆記）

智能添加語法

在添加任務時，可以使用 RTM 的智能添加語法：

示例："Review report ^friday !1 #work =1h *weekly"（週五審查報告，高優先級，工作標籤，預計 1 小時，每週重複）

可用工具

任務管理

• 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"
}

開發相關

# 安裝開發依賴
make dev

# 運行代碼檢查
make lint

# 運行測試
make test

# 運行測試並生成覆蓋率報告
make test/coverage

# 格式化代碼
make format

Docker 使用

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

Claude 桌面應用的 Docker 配置如下：

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

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。

🙏 致謝

• Remember The Milk 提供了出色的任務管理服務。
• FastMCP 提供了 MCP 框架。
• Anthropic 提供了 Claude 和 MCP 規範。