關聯 Todoist 的 MCP(模型情境協定)伺服器到 Claude Code,並直接從終端機管理您的任務。關聯後,您無需離開編碼環境,即可創建、讀取和更新 Todoist 任務與項目,這有助於您在跟進工作的同時保持專注。
您還可以通過 Claude 中的 Todoist 連接器將 Todoist 關聯到 Claude,以實現聊天為主的工作流程。關聯後,Claude 可以 閱讀、創建 和 更新 您的 Todoist 任務 和 項目。有關說明,請參閱通過 Claude 使用 Todoist。
查看具體要求
- Claude 付費方案——Pro、Max、Team、Enterprise 或 Console。免費的 Claude.ai 方案不包括 Claude Code 訪問。
- Claude Code 已安裝並在您的機器上完成驗證。
- 您將透過 OAuth 登入,這表示您正在授權 Claude Code 透過官方 Todoist MCP 伺服器訪問 Todoist。
在 Claude Code 中建立 Todoist MCP
1. 新增 Todoist MCP 伺服器
開啟您的終端機並執行以下指令:
claude mcp add --transport http Todoist https://ai.todoist.net/mcp
2. 確認伺服器已新增
指令完成後,您會在終端機中看到以下回應:
1 個 MCP 伺服器需要授權 · /mcp這表示 Todoist MCP 伺服器已添加,並等待您授權。
3. 開啟 MCP 伺服器列表
在同一個終端機中,輸入 /mcp 並按下 Enter 鍵。這會開啟所有已安裝的 MCP 伺服器列表,包括新加入的 Todoist 伺服器。
4. 選擇 Todoist 伺服器
使用 ↑ 和 ↓ 箭頭鍵在列表中找到 Todoist,然後輸入。
5. 完成授權流程
依照螢幕上的指示登錄您的 Todoist 帳戶,並授予 Claude Code 必要的權限。
授權後,Todoist 即可在 Claude Code 中使用。
Claude Code 將能存取哪些內容
關聯後,Claude Code 即可使用 Todoist MCP 伺服器來:
- 閱讀您的 Todoist 任務和項目
- 創建任務和項目
- 更新任務和項目 (例如:重新命名、重新安排或移動到不同的項目)
警告
您可以執行的操作範例
關聯後,以下是一些效果不錯的提示詞:
| 目錄 | 示例提示詞 |
|---|---|
| 從代碼記錄任務 | 添加任務至 Todoist:「修正 login.js 中的驗證錯誤」,並將其放入工程項目中。 創建任務「為付款模組編寫單元測試」,並將截止日期設定為本週五。 |
| 規劃您的工作 | 列出我所有過期的 Todoist 任務,並幫助我決定今天該處理哪些。 顯示我本週所有到期的任務,並建議我實際能完成哪些。 |
| 整理收件箱 | 瀏覽我的 Todoist 收件箱,並將每個條目轉化為清晰、可操作的下一步。 將所有標記為「等待中」的任務移至「等待處理」版塊,並為下週一新增一個追蹤任務。 |
| 保持專注 | 我正在開發結帳功能,請檢查 Todoist,並告訴我有沒有任何相關的未完成任務。 為此文件中的每個待辦評論添加一個任務,並將它們全部放入當前衝刺項目中。 |
隱私與數據處理
當您透過 MCP 關聯 Todoist 時,您的任務資料會同時分享給 Todoist 的伺服器和 Claude。Todoist 端的資料處理受 Todoist 隱私保護政策保護;進入 Claude 環境的資料 (您的任務、項目等) 也受 Anthropic 隱私保護政策約束。
若要更安心,您可以隨時前往 Todoist 的 設定 > 關聯應用,檢查您已授予的權限。
取消關聯 Todoist MCP
您可以在兩個地方取消關聯:
- 在 Claude Code 中:在您的終端機中執行
claude mcp remove todoist以移除伺服器。 - 在 Todoist 中:從設定 > 關聯應用移除訪問權,以廢除 Claude Code 的權限。
檢修故障
claude mcp add 指令無法辨識
請確認 Claude Code 已安裝並更新至最新版本。如需安裝說明,請參閱 Claude Code 文件。
OAuth 瀏覽器視窗未打開
請再試著執行一次 Claude Code 指令。如果視窗仍然沒有出現,請檢查您的瀏覽器是否阻擋了彈出式視窗,然後再試一次。
伺服器顯示在 Claude MCP 列表 中,但 Todoist 工具無法使用
新增伺服器後,請啟動新的 Claude Code 會話。MCP 伺服器只會在會話啟動時加載,因此現有的伺服器不會接收新的連線。
報告程式錯誤或請求功能
Todoist MCP 伺服器是開源代碼的。您可以在官方的 GitHub 上的 Todoist AI 存儲庫 中報告程式錯誤、請求功能或瀏覽已知問題。
聯絡我們
如果您對關聯 Todoist MCP 到 Claude Code 存在疑問或想瞭解更多資訊,請聯絡我們。