kuhyx/todo-app
1
0
Fork 0
mirror of https://github.com/kuhyx/todo-app.git synced 2026-11-11 13:27:46 +01:00
Code Issues Actions 5 Packages Projects Releases Wiki Activity
951b00e263
todo-app/mcp
History
Krzysztof kuhy Rudnicki 951b00e263
Some checks failed
dependency freshness / dependencies on newest stable (push) Has been cancelled
Details
file-length / file length <= 250 lines (push) Has been cancelled
Details
md-naming / markdown naming convention (push) Has been cancelled
Details
release-apk / release (APK) (push) Has been cancelled
Details
Grade the todo MCP against 3.14 too, not just run on it 
ruff and mypy were still grading `mcp/` against 3.10 while `requires-python`
had already moved to 3.14, so `datetime.timezone.utc` survived where
`datetime.UTC` is now correct (UP017). `pin_ci_python.py` rewrites the knobs;
ruff's `--select UP,I,F401 --fix` did the rest.

`mcp/` has no ruff hook in `.pre-commit-config.yaml`, so it also carries six
pre-existing CPY001 (missing copyright notice) findings. Those fire identically
at py310 and are left alone -- they are not this change's to fix.

24 tests pass at 100% line and branch coverage.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SfnJmxxsZ534AKk16rC2Gr
2026-08-29 11:46:10 +02:00
..
scripts Add read-only MCP server for the backlog 2026-07-10 21:20:39 +02:00
todo_mcp Grade the todo MCP against 3.14 too, not just run on it 2026-08-29 11:46:10 +02:00
.gitignore Add read-only MCP server for the backlog 2026-07-10 21:20:39 +02:00
pyproject.toml Grade the todo MCP against 3.14 too, not just run on it 2026-08-29 11:46:10 +02:00
README.md Add read-only MCP server for the backlog 2026-07-10 21:20:39 +02:00

README.md

todo backlog MCP server

A small, standalone, read-only MCP server that lets Claude Code (and its subagents) query the todo app's backlog.

The todo app is Dart/Flutter and stores notes in a sqlite_crdt database that must never be touched from outside the app (CRDT writes corrupt cross-device merge). Instead, this server reads the app's exported BACKLOG.md — the canonical NotesMarkdown snapshot written by Settings → "Export notes".

Staleness note

BACKLOG.md is a manual export, so it can be out of date. Every tool result includes the file's modification time (mtime) so you can judge freshness. If the file is missing, tools return backlog_found: false with a message telling you to export it from the app — they never crash.

Tools (all read-only)

  • list_backlog(priority: str | None = None, status: str | None = None, limit: int = 100) — notes, optionally filtered by priority (low/medium/high) and/or status (todo/inProgress/done/abandoned), plus total, returned, and mtime.
  • get_note(note_id: str) — one note by id, or found: false.
  • backlog_stats() — counts by_status and by_priority, total, and mtime.

Nothing here writes to the database or to BACKLOG.md.

Setup

mcp/scripts/setup_mcp.sh

This creates ~/.venvs/todo-mcp, installs this package (which pulls in the mcp SDK), and verifies the imports. The server is registered via the repo-root .mcp.json; restart Claude Code in this repo and approve the project MCP server prompt. Override the backlog location with TODO_BACKLOG_PATH (defaults to ~/todo/BACKLOG.md).

Development

~/.venvs/todo-mcp/bin/pip install -e mcp pytest pytest-cov ruff mypy
~/.venvs/todo-mcp/bin/python -m pytest mcp/todo_mcp/tests \
    --cov=todo_mcp --cov-branch --cov-report=term-missing --cov-fail-under=100