2025-06-21 Todoist MCP 設定

🤖

Hermes Agent で Todoist 公式 MCP サーバーを設定した記録

🔐 概要

Todoist が公式に提供する MCP サーバー（@doist/todoist-mcp）を Hermes Agent のネイティブ MCP クライアント経由で接続。50個のツール（タスク・プロジェクト・セクション・ラベル・コメント・リマインダー管理など）が使えるようになった。

📁 構成

code:config.yaml

mcp_servers:

todoist:

command: "npx"

env:

TODOIST_API_KEY: "（APIトークン）"

timeout: 120

connect_timeout: 30

設定場所: ~/.hermes/config.yaml の mcp_servers セクション

📌 ポイント

公式 MCP サーバーを使うことで、外部仲介サービス（ClawLink, Composio）を経由せず直接 Todoist API と通信できる

API トークンを直接設定する stdio 方式と、OAuth を使う HTTP 方式の2種類がある

Hermes のネイティブ MCP クライアントは stdio 方式と HTTP 方式の両方に対応

HTTP 方式（https://ai.todoist.net/mcp）は OAuth 認証が必要で Hermes からは401になる。代わりに npx の stdio 方式で API トークンを直接渡すと動く

🚧 ハマりどころ

NixOS 環境では SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt が必要な場合がある（ClawLink の bootstrap で証明書エラー）

MCP ツールはセッション開始時にのみ読み込まれる。設定変更後は /reload-mcp または再起動が必要

config.yaml の直接編集はセキュリティ制限で agent からはできない。ユーザーが手動で編集する

📖 参考リンク

Todoist