Metadata-Version: 2.4
Name: todoist-toolkit
Version: 0.1.1
Summary: Todoist CLI, Claude skill, and MCP tool backed by the official Todoist API
Author-email: Luke Steuber <luke@dr.eamer.dev>
License: MIT
Project-URL: Homepage, https://github.com/lukeslp/todoist-toolkit
Project-URL: Repository, https://github.com/lukeslp/todoist-toolkit
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: todoist-api-python>=2.1.4
Requires-Dist: typer>=0.12.3
Provides-Extra: gemini
Requires-Dist: google-generativeai>=0.8.3; extra == "gemini"
Provides-Extra: dev
Requires-Dist: pytest>=7.4; extra == "dev"
Requires-Dist: pytest-mock>=3.12; extra == "dev"
Requires-Dist: pytest-cov>=4.1; extra == "dev"
Requires-Dist: black>=24.3; extra == "dev"
Requires-Dist: ruff>=0.6; extra == "dev"
Provides-Extra: all
Requires-Dist: todoist-toolkit[dev,gemini]; extra == "all"

# todoist-toolkit

Todoist CLI + Claude skill + MCP server built on the official `todoist-api-python` SDK.

## Features
- `todo` CLI for add/list/get/update/complete/delete/projects/recap
- Claude skill + MCP stdio server (`todoist_mcp`) exposing the same operations as tools
- Shared core layer with structured errors and JSON-friendly output
- Optional recap summarization via Gemini (`GOOGLE_API_KEY`)

## Install (editable)
```bash
pip install -e packages/todoist-toolkit[all]
```

## Environment
- `TODOIST_API_KEY` (required): Todoist REST API token
- `GOOGLE_API_KEY` (optional): enables LLM summaries for `todo recap`

## CLI Examples
```bash
# List active tasks
todo list

# Add a task
todo add "Prep deck" --due "tomorrow 9am" --priority 4 --project "Work"

# Complete a task
todo complete 2995104339

# Recap (uses Gemini if GOOGLE_API_KEY is set)
todo recap --days 1
```

## MCP / Claude Skill
Start the stdio server:
```bash
python -m todoist_toolkit.mcp_server
```

Add to Claude config (example):
```json
{
  "mcpServers": {
    "todoist": {
      "command": "python3",
      "args": ["/home/coolhand/packages/todoist-toolkit/src/todoist_toolkit/mcp_server.py"],
      "env": {"TODOIST_API_KEY": "<token>", "GOOGLE_API_KEY": "<optional>"}
    }
  }
}
```

## Tests
```bash
cd packages/todoist-toolkit
pytest
```
