Metadata-Version: 2.4
Name: todoist-mcp-plus
Version: 1.1.0
Summary: MCP Server for Todoist — Connect AI agents to your Todoist tasks
Project-URL: Homepage, https://github.com/LittlePeter52012/todoist-mcp
Project-URL: Issues, https://github.com/LittlePeter52012/todoist-mcp/issues
License: MIT
License-File: LICENSE
Keywords: ai,mcp,productivity,tasks,todo,todoist
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: mcp[cli]>=1.0.0
Requires-Dist: requests>=2.28.0
Description-Content-Type: text/markdown

# Todoist MCP Server ✅

[![PyPI](https://img.shields.io/pypi/v/todoist-mcp)](https://pypi.org/project/todoist-mcp/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**Connect AI agents to your [Todoist](https://todoist.com) tasks** via the Model Context Protocol (MCP).

Create, search, complete, and manage your Todoist tasks — all from Claude, Gemini, Cursor, or any MCP-compatible AI agent.

---

## ✨ Features

| Category       | Tools                                                                                                 | Description                                        |
| -------------- | ----------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| 📋 Tasks        | `list_tasks`, `get_task`, `create_task`, `update_task`, `complete_task`, `delete_task`, `reopen_task` | Full task CRUD with priority, due dates, labels    |
| 🔍 Smart Search | `search_task_by_name`, `complete_task_by_name`, `delete_task_by_name`, `update_task_by_name`          | Find and operate on tasks by name (fuzzy matching) |
| 📁 Projects     | `list_projects`, `create_project`, `get_project`, `delete_project`                                    | Manage projects                                    |
| 📑 Sections     | `list_sections`, `create_section`, `delete_section`                                                   | Organize tasks into sections                       |
| 🏷️ Labels       | `list_labels`, `create_label`                                                                         | Tag management                                     |
| 💬 Comments     | `list_comments`, `add_comment`                                                                        | Task comments                                      |
| ⚙️ Config       | `set_api_token`, `get_current_config`                                                                 | Runtime token management                           |

**24 tools total** — the most comprehensive Todoist MCP server available.

---

## 🚀 Quick Start

### Install

```bash
pip install todoist-mcp
```

### Get Your API Token

1. Go to [Todoist Settings → Integrations](https://app.todoist.com/app/settings/integrations)
2. Scroll to **Developer** → copy your **API Token**

---

## 📋 Configuration

All credentials are passed via **environment variables** — no tokens in code.

| Variable            | Description            | Required |
| ------------------- | ---------------------- | -------- |
| `TODOIST_API_TOKEN` | Your Todoist API Token | ✅        |

---

## 🔧 Platform Configuration

### Claude Desktop

```json
{
  "mcpServers": {
    "todoist": {
      "command": "todoist-mcp",
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here"
      }
    }
  }
}
```

### Gemini CLI

Add to `~/.gemini/settings.json`:

```json
{
  "mcpServers": {
    "todoist": {
      "command": "todoist-mcp",
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here"
      }
    }
  }
}
```

### Cursor

Add to Cursor Settings → MCP:

```json
{
  "todoist": {
    "command": "todoist-mcp",
    "env": {
      "TODOIST_API_TOKEN": "your_api_token_here"
    }
  }
}
```

---

## 💡 Usage Examples

Once configured, ask your AI agent:

- *"Show me my tasks for today"*
- *"Create a task: Buy groceries, due tomorrow, priority 2"*
- *"Complete the task about groceries"*
- *"Search for tasks related to meeting"*
- *"List all my projects"*
- *"Add a comment to my latest task"*

---

## 🔐 Runtime Configuration

Change tokens without restarting:

- **`set_api_token`** — Switch Todoist account at runtime
- **`get_current_config`** — Check current configuration

---

## 📄 License

MIT License — see [LICENSE](LICENSE) for details.
