Rtm MCP

🚀 RTM MCP Server

Remember The Milk のタスク管理のための、本番環境で使用可能な Model Context Protocol (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. "Apply for an API Key" をクリックします。
3. フォームに入力します — アプリ名（例："Claude MCP"）、説明など、何でも構いません。
4. 送信後、APIキーと共有シークレットが表示されます — 両方を保存してください。

2. セットアップを実行する

rtm-setup

これにより、以下のことが行われます。

• API資格情報の入力を求められます。
• 承認のためにブラウザが開きます。
• 認証トークンが ~/.config/rtm-mcp/config.json に保存されます。

3. Claude Desktopを設定する

~/.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"

基本的な使用法

# 設定が完了した後、Claudeにタスク管理を依頼する自然言語を入力する例
# 例えば、ターミナルやClaudeのインターフェースで以下のようなコマンドを入力
# 「Show my tasks due today」

高度な使用法

# スマートな追加構文を使用してタスクを追加する例
# コマンドラインやClaudeのインターフェースで以下のようなコマンドを入力
# 「Review report ^friday !1 #work =1h *weekly」

📚 ドキュメント

スマートな追加構文

タスクを追加する際には、RTMのスマートな追加構文を使用します。

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

利用可能なツール

タスク

• list_tasks - フィルターを指定してタスクをリストする
• add_task - 新しいタスクを作成する
• complete_task / uncomplete_task - タスクを完了または再開する
• delete_task - タスクを削除する
• postpone_task - 期限日を1日延期する
• 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

Docker用のClaude Desktop設定：

{
  "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
• MCPフレームワークを提供している FastMCP
• ClaudeとMCP仕様を提供している Anthropic