TodoMCP
expose your codebase TODO/FIXME backlog as an MCP tool your agent can actually act on
npx -y github:Isco0819/todomcpEver run into this?
Like todo-tree (5M+ VSCode installs) and leasot (1.5k GitHub stars), devs have always craved a searchable TODO inventory — but AI agents have zero visibility into it. Your Claude Code or Cursor agent cannot ask "what FIXMEs exist in the auth module?" and get structured results. Every hidden comment sits outside the agent loop, unfixed forever.
The fix
todomcp scans your codebase for TODO/FIXME/HACK/NOTE/XXX comments and exposes them as MCP tools with file, line, type, git-blame author, and age. Your agent can now list, filter, and prioritize the hidden backlog — and optionally relay-push items to GitHub Issues.
What it does
- MCP tools: list_todos(dir?, type?), get_todos_near_file(path), summarize_debt() — structured JSON your agent can act on
- npx CLI mode: todomcp scan → pretty table with file:line, type, author, days-old, comment text
- GitHub Issues relay: todomcp push --token $GH_TOKEN groups FIXMEs by module and opens issues (relay only, no paid API)