todoist-mcp

@IAMSamuelRodda/todoist-mcp

0 Stars 10 次浏览 IAMSamuelRodda 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "todoist": {
      "args": [
        "/home/samuel/repos/todoist-mcp/todoist_mcp.py"
      ],
      "command": "/home/samuel/repos/todoist-mcp/.venv/bin/python",
      "env": {
        "TODOIST_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

服务介绍

Todoist MCP Server

MCP (Model Context Protocol) server for Todoist integration, allowing AI assistants to manage your tasks, projects, and labels.

Features

Tasks: Create, list, update, complete, reopen, and delete tasks
Projects: List and create projects, including sub-projects
Labels: List and create labels for task organization
Filters: Support for Todoist filter syntax (today, overdue, p1, etc.)
Natural language dates: Use tomorrow, next Monday, every week, etc.

Setup

1. Get Your Todoist API Token

Open Todoist (web or app)
Go to Settings Integrations Developer
Copy your API token

2. Install Dependencies

cd repos/todoist-mcp
python -m venv .venv
source .venv/bin/activate
uv pip install -r requirements.txt

3. Configure Claude Code

Add to your Claude Code MCP settings (~/.claude/mcp_settings.json):

{
  "mcpServers": {
    "todoist": {
      "command": "/home/samuel/repos/todoist-mcp/.venv/bin/python",
      "args": ["/home/samuel/repos/todoist-mcp/todoist_mcp.py"],
      "env": {
        "TODOIST_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Available Tools

Tool	Description
`todoist_list_projects`	List all projects
`todoist_get_project`	Get project details
`todoist_create_project`	Create a new project
`todoist_list_tasks`	List tasks with filters
`todoist_get_task`	Get task details
`todoist_create_task`	Create a new task
`todoist_update_task`	Update a task
`todoist_complete_task`	Mark task complete
`todoist_reopen_task`	Reopen a completed task
`todoist_delete_task`	Delete a task
`todoist_list_labels`	List all labels
`todoist_create_label`	Create a new label

Usage Examples

Once configured, you can ask Claude:

"Show me my tasks for today"
"Create a task to review the quarterly report due next Friday"
"List all my projects"
"Mark task 123456789 as complete"
"What are my overdue tasks?"
"Create a high-priority task in my Work project"

Filter Syntax

The todoist_list_tasks tool supports Todoist's filter syntax:

today - Tasks due today
tomorrow - Tasks due tomorrow
overdue - Overdue tasks
p1, p2, p3, p4 - Filter by priority
no due date - Tasks without due dates
7 days - Tasks due in the next 7 days
@label_name - Tasks with specific label
#project_name - Tasks in specific project

License

MIT

查看源码项目主页