Todo AI Manager

REST API и Telegram бот для управления задачами в Todoist через естественный язык. Пишете текст на русском — AI агент интерпретирует его и выполняет нужное действие в Todoist.

Как это работает

Telegram / POST /chat
        ↓
   FastAPI / bot.py
        ↓
AI Agent (openai-agents) — openai/gpt-4o-mini через routerai.ru
        ↕ MCP Streamable HTTP
Todoist MCP Server (ai.todoist.net)
        ↕
   Todoist API

Установка

git clone <repo>
cd todo-ai-manager-new

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Скопируйте .env.example в .env и заполните ключи:

cp .env.example .env

ROUTER_AI_API_KEY=ваш_ключ_от_routerai.ru
TODOIST_API_KEY=ваш_токен_todoist
TELEGRAM_BOT_TOKEN=ваш_токен_от_botfather

Запуск

Docker (рекомендуется)

docker compose up --build

Запустит сразу оба сервиса: API на порту 8000 и Telegram бот.

docker compose up --build api   # только REST API
docker compose up --build bot   # только бот

Локально

source venv/bin/activate

python bot.py                                        # Telegram бот
uvicorn main:app --host 0.0.0.0 --port 8000 --reload # REST API

Swagger UI: http://localhost:8000/docs

Бот и API независимы — можно запускать оба одновременно.

Использование Telegram бота

Напишите боту любым естественным языком:

Напомни завтра утром купить молоко
Что у меня на сегодня?
Покажи все задачи
Удали задачу про молоко

Использование REST API

# Создать задачу
curl -X POST http://localhost:8000/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Напомни завтра утром купить пельмени"}'

# Задачи на сегодня
curl -X POST http://localhost:8000/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Что у меня на сегодня?"}'

# Все задачи
curl -X POST http://localhost:8000/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Покажи все мои задачи"}'

Формат ответа:

{"response": "Задача 'Купить пельмени' создана на завтра в 9:00"}

Соглашения о времени

Фраза	Время
"утром"	09:00
"вечером"	19:00
"завтра" (без времени)	завтрашняя дата без времени

Структура проекта

├── .env                  # API ключи (не коммитить)
├── .env.example          # Шаблон для .env
├── requirements.txt
├── config.py             # Загрузка переменных окружения
├── agent.py              # AI агент + подключение к Todoist MCP
├── main.py               # FastAPI приложение
└── bot.py                # Telegram бот

Получение ключей

• ROUTER_AI_API_KEY — регистрация на routerai.ru
• TODOIST_API_KEY — Settings → Integrations → Developer token на todoist.com
• TELEGRAM_BOT_TOKEN — создать бота через @BotFather командой /newbot