Plain Todo MCP
A shared to-do list for AI coding agents, kept in a plain Markdown file in your project. When you ask, the agent turns the tasks agreed in a conversation into AGENT_TODO.md, so you or another agent can pick up where it left off. Fully open source.
Get it: PyPI
More: Source code · Documentation
What it does
- Merges the tasks agreed in the current conversation into
AGENT_TODO.md, keeping what is already open or done. - Keeps a short Working Memory note at the top of the file: what is in progress, what comes next and what is blocked.
- Shows the commits made since the list was last saved, so finished tasks can be marked done.
- Schedules tasks to revisit with
Check after:dates, and parks blocked work in a Waiting section until its date arrives. - Gives a subfolder its own
AGENT_TODO.md, linked from the list at the top of the project. - Refuses to overwrite changes made since the agent last read the list, and refuses a list it cannot read correctly.
- Works with Claude Code, Codex, Cursor, VS Code and other MCP clients. The list stays ordinary Markdown you can read, edit and keep in Git.
Privacy
Internet. The server does not connect to the internet and does not listen on a network port. It talks only to the MCP client that started it, on the same computer. If you start it with uvx, that tool downloads the package from PyPI; the download is done by uvx, not by the server.
Your AI assistant decides what goes in the list. The server never sees your conversation. The assistant you connect reads the conversation, writes the tasks and reads the list back. If that assistant uses a cloud AI service, the list it reads may be sent to that service under its own settings and privacy policy. Do not put secrets in your tasks.
Your files. Within your project, the server reads and writes only files named AGENT_TODO.md. While saving, it uses a short-lived temporary file and a lock file named AGENT_TODO.md.lock in the same folder.
Git. To show what changed since the list was last saved, the server runs git log on your computer and reads the IDs and messages of up to 30 recent commits. It does not change your Git history.
What else it keeps. Nothing. The server writes no logs or settings files, and keeps nothing outside your project folder.
Removing its data. Delete AGENT_TODO.md and AGENT_TODO.md.lock. If the project is in Git, earlier versions of committed files remain in its history.
See also the Privacy Policy for what applies to every Plain Text Office app.
Feedback
Found a bug or want a feature? Open an issue on GitHub or use the contact form.
