# Фокус-планер

> A personal task planner with a focus timer (Russian UI), built to be driven by AI agents over MCP. Tasks with time estimates, day plans with a minute budget, projects with goals and milestones, a live focus timer / pomodoro, statistics, a shared AI memory, and a feedback book that agents write to the developer.

## Connect
- MCP server: https://localhost:3010/api/v1/mcp — Streamable HTTP (POST only, JSON responses), protocol versions 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05.
- Auth: OAuth 2.1 (dynamic client registration + PKCE; discovery at https://localhost:3010/.well-known/oauth-protected-resource) or an API key: `Authorization: Bearer pt_…` (created by the user in Settings → API-ключи).
- Step-by-step for Claude, ChatGPT, Claude Code, Cursor, VS Code, Windsurf, Gemini CLI, Codex: https://localhost:3010/connect
- REST API with the same key: https://localhost:3010/api/v1 — OpenAPI: https://localhost:3010/api/v1/openapi.json
- Release notes: https://localhost:3010/changelog (JSON: https://localhost:3010/api/v1/changelog)
- Rate limit: 60 requests/minute per key; batch_execute runs up to 50 operations as one request.

## How to work with it
- Start with get_overview: the day's tasks, budget, overdue tasks, live timer, plus "memory" (notes about the person saved by AI agents) and "feedbackUpdates" (the developer's replies to earlier reports — tell the person).
- Look before you write: search / list_tasks / list_projects. Never create a project just because a name was mentioned.
- complete_task is the only way to mark a task done. Deleting archives by default; permanent deletion only on an explicit request.
- Names instead of ids work almost everywhere (taskName / projectName, fuzzy-matched); ambiguous names return candidates — ask the person.
- Dates: "today", "tomorrow", a weekday, "next friday" or YYYY-MM-DD, in the planner's timezone (Europe/Moscow by default).
- Tasks you take on yourself: assignee "claude" — they don't eat the person's day budget.
- The timer is live: starting it starts a real clock the person sees.
- Remember lasting preferences with remember (shared by every AI the person connects); no secrets.
- Report problems, friction, missing features and the person's unmet requests with submit_feedback; after a substantial session, write_session_report with a 1–5 rating. The developer reads every item and ships fixes; whats_new lists releases.

## Prompts
- plan_my_day — Спланировать день: Разобрать день и составить реалистичный план под бюджет времени.
- weekly_review — Обзор недели: Что сделано за неделю, сколько было фокуса, что висит и на чём сосредоточиться дальше.
- quick_capture — Быстро записать задачи: Разобрать свободный текст (поток мыслей, заметки со встречи, расшифровку голоса) на задачи и создать их.
- onboarding — Знакомство и настройка: Нейросеть узнаёт, как вы работаете, запоминает это и настраивает планер под вас.
- feedback_report — Отзыв разработчику: Нейросеть разбирает, что в планере работало плохо и чего не хватило, и пишет в книгу жалоб и предложений.

## Resources
- planer://today, planer://projects, planer://settings, planer://memory, planer://feedback, planer://changelog
- Templates: planer://day/{date}, planer://task/{id}, planer://project/{id}

## Tools
- get_overview — Get overview
- search — Search
- reschedule_tasks — Reschedule tasks (writes)
- plan_day — Plan day (writes)
- list_tasks — List tasks
- get_task — Get task
- create_task — Create task (writes)
- update_task — Update task (writes)
- delete_task — Delete task (writes)
- complete_task — Complete task (writes)
- reopen_task — Reopen task (writes)
- archive_task — Archive task (writes)
- restore_task — Restore task (writes)
- unschedule_task — Unschedule task (writes)
- extend_task_budget — Extend task budget (writes)
- list_projects — List projects
- get_project — Get project
- create_project — Create project (writes)
- update_project — Update project (writes)
- delete_project — Delete project (writes)
- restore_project — Restore project (writes)
- get_day_plan — Get day plan
- list_day_plans — List day plans
- update_day_plan — Update day plan (writes)
- get_settings — Get settings
- update_settings — Update settings (writes)
- list_sessions — List sessions
- get_timer — Get timer
- start_timer — Start timer (writes)
- pause_timer — Pause timer (writes)
- resume_timer — Resume timer (writes)
- stop_timer — Stop timer (writes)
- get_pomodoro — Get pomodoro
- start_pomodoro — Start pomodoro (writes)
- start_pomodoro_task — Start pomodoro task (writes)
- stop_pomodoro_task — Stop pomodoro task (writes)
- pause_pomodoro — Pause pomodoro (writes)
- resume_pomodoro — Resume pomodoro (writes)
- start_pomodoro_break — Start pomodoro break (writes)
- skip_pomodoro_break — Skip pomodoro break (writes)
- finish_pomodoro_break — Finish pomodoro break (writes)
- dismiss_pomodoro_break_over — Dismiss break-over reminder (writes)
- stop_pomodoro — Stop pomodoro (writes)
- update_project_goal — Update project goal (writes)
- list_milestones — List milestones
- create_milestone — Create milestone (writes)
- update_milestone — Update milestone (writes)
- delete_milestone — Delete milestone (writes)
- get_changes — Get changes
- batch_execute — Batch execute (writes)
- list_modules — List modules
- get_module — Get module
- enable_module — Enable module (writes)
- disable_module — Disable module (writes)
- update_module_settings — Update module settings (writes)
- run_module_command — Run module command (writes)
- water_add_intake — Записать воду (writes)
- water_remove_intake — Отменить запись воды (writes)
- water_get_day — Вода за день
- water_set_goal — Цель по воде (writes)
- workouts_log_workout — Записать тренировку (writes)
- workouts_remove_workout — Отменить тренировку (writes)
- workouts_get_day — Тренировки за день
- workouts_get_week — Тренировки за неделю
- workouts_set_weekly_goal — Цель тренировок на неделю (writes)
- books_add_book — Добавить книгу (writes)
- books_update_book — Изменить книгу (writes)
- books_remove_book — Убрать книгу (writes)
- books_log_reading — Записать чтение (writes)
- books_remove_reading — Отменить запись чтения (writes)
- books_get_day — Чтение за день
- books_get_books — Книги
- books_set_goal — Цель чтения на день (writes)
- get_layout — Get layout
- add_widget — Add widget (writes)
- move_widget — Move widget (writes)
- resize_widget — Resize widget (writes)
- hide_widget — Hide widget (writes)
- remove_widget — Remove widget (writes)
- float_widget — Float widget (writes)
- dock_widget — Dock widget (writes)
- reset_layout — Reset layout (writes)
- submit_feedback — Submit feedback to the developer (writes)
- write_session_report — Write session report (writes)
- list_feedback — List feedback
- remember — Remember (writes)
- recall — Recall
- forget — Forget (writes)
- get_stats — Get stats
- whats_new — What's new
- submit_feedback — Submit feedback to the developer (writes)
- write_session_report — Write session report (writes)
- list_feedback — List feedback
- remember — Remember (writes)
- recall — Recall
- forget — Forget (writes)
- get_stats — Get stats
- whats_new — What's new