Taskdog MCP
MCP-сервер локального таск-менеджера Taskdog: агент создает задачи, ведет их жизненный цикл и разбивает крупные на подзадачи.
- 361 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент создает, меняет и удаляет задачи в локальной базе через HTTP API сервера.
Установка
- Работает в
Ручная установка
make install-mcpПервая команда раздела Installation в README пакета `taskdog-mcp`, выполняется из корня клона. Глобально ставит `uv tool install taskdog-mcp`. Нужен запущенный `taskdog-server`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент создает, меняет и удаляет задачи в локальной базе через HTTP API сервера.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Taskdog — менеджер задач с интерфейсами CLI, TUI и REST API, расчетом расписания и учетом времени. Данные лежат в локальной SQLite. Пакет `taskdog-mcp` подключает к нему MCP-клиент: тот работает с задачами обычными фразами. Инструменты закрывают создание и правку (`create_task`, `update_task`, `delete_task`), жизненный цикл (`start_task`, `complete_task`, `pause_task`, `cancel_task`, `reopen_task`), статистику, зависимости, теги и заметки. `decompose_task` разбивает крупную задачу на подзадачи, а `get_executable_tasks` показывает, что агент может сделать сам.
Для кого. Тем, кто ведет личные задачи в терминале и хочет говорить с Claude Desktop или другим MCP-клиентом о планах, не открывая CLI.
Подходит, если
- Диктуете планы на день, а агент заводит задачи и расставляет приоритеты.
- Крупную задачу разбивают на подзадачи и связывают зависимостями.
- Агент спрашивает, какие задачи он может выполнить сам, и берет их в работу.
- Заметки к задаче обновляются по ходу работы, а статистика по тегам помогает подвести итоги недели.
Не подходит, если
- Командная работа над общим списком: проект рассчитан на индивидуальное использование.
- Сервер `taskdog-server` нельзя держать запущенным: MCP обращается к нему по HTTP.
- Нужен облачный сервис с синхронизацией между устройствами: данные хранятся локально.
Пример запроса к агенту
Заведи задачу «написать тесты для API» с приоритетом 10, разбей ее на подзадачи и покажи, какие из них можно начать сегодня.MCP
- Транспорт
- stdio
- Авторизация
- ключ необязателен
Переменные окружения
`TASKDOG_API_BASE_URL`- Адрес `taskdog-server`, по умолчанию `http://127.0.0.1:8000`.
`TASKDOG_API_KEY`секрет- Ключ API, нужен при включенной аутентификации сервера.
`TASKDOG_MCP_NAME`- Имя MCP-сервера, по умолчанию `taskdog`.
`TASKDOG_MCP_LOG_LEVEL`- Уровень журнала, по умолчанию `INFO`.
Ограничения
MCP-пакет не работает сам по себе: должен быть запущен `taskdog-server`, по умолчанию на `http://127.0.0.1:8000`. Нужен Python 3.13 или новее. Проект рассчитан на одного пользователя и хранит данные в локальной SQLite. Полноценно поддерживаются Linux и macOS, Windows пока экспериментальный, рекомендован WSL2. Инструменты `delete_task` и `update_task` меняют данные, поэтому агенту стоит давать только нужные задачи. Ключ API необязателен и нужен, если сервер требует аутентификацию.
Как отключить. Удалите блок `taskdog` из конфигурации MCP-клиента и перезапустите клиент. Сервер `taskdog-server` и базу SQLite остановите и удалите отдельно, если они больше не нужны.
Частые вопросы
Как настроить адрес сервера?
Создайте `~/.config/taskdog/mcp.toml` с `base_url` в разделе `[api]` или задайте переменную `TASKDOG_API_BASE_URL`. Переменные окружения важнее файла.
Нужен ли API-ключ?
Только если сервер требует аутентификацию. Ключ записывают в `api_key` файла настроек или в переменную `TASKDOG_API_KEY`.
Как подключить сервер к Claude Desktop?
Добавьте в `claude_desktop_config.json` блок `mcpServers` с записью `taskdog` и командой `taskdog-mcp`. Для разработки есть вариант через `uv --directory ... run taskdog-mcp`.
Что умеет decompose_task?
Разбивает крупную задачу на подзадачи с помощью ИИ. Зависимости между ними добавляют инструментом `add_dependency`.
Что делать при ошибке «Cannot connect to API server»?
Проверьте, что `taskdog-server` запущен: `curl http://127.0.0.1:8000/health`. Затем сверьте адрес в `mcp.toml`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыМенеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI
MCP-сервер для Todoist: Claude создает, ищет, правит, завершает и удаляет задачи по обычной фразе, пять инструментов
Официальный MCP-сервер Todoist: агент ищет, создает и меняет задачи и проекты в вашем аккаунте
MCP-сервер канбан-доски Doska: агент создает карточки, двигает их по колонкам, ставит сроки и ищет задачи по всем доскам
Microsoft To Do MCP передает агенту задачи с пунктами списка и правилами повторения для работы с личным планом пользователя.
MCP-сервер для Super Productivity: агент создает задачи, раскладывает по проектам и меткам, запускает таймер и читает журнал.
Коротко о README
Репозиторий организован как монорепозиторий из пяти пакетов: ядро, клиент HTTP API, сервер FastAPI, CLI и TUI, а также `taskdog-mcp`. Для знакомства есть демо-образ Docker с примерами задач.