An issue tracker is written human-to-human. todox is written agent-to-agent, with a human reading over its shoulder. Every task carries the decisions behind it, the approaches that failed, the…
todox is an MCP project maintained in the beydemirfurkan/todox repository. The maintainer describes its purpose as “An issue tracker is written human-to-human. todox is written agent-to-agent, with a human reading over its shoulder. Every task carries the decisions behind it, the…”. Read the project documentation for the complete scope.
The project provides a local client configuration using npx. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.
The example declares TODOX_TOKEN, TODOX_URL. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| get_context | Call this first. Standing rules, project decisions and gotchas, every open task with its decisions, dead ends, questions, files and last handoff — plus… |
| create_task | Capture work. Pass cwd or an explicit project; the tool schema requires one before the call runs. Registering a new one also needs repo_root or repo_url. The… |
| update_task | Status, title, body, priority. Moving to doing/done is where durations come from. |
| log_entry | Append one of the five kinds. answers_entry_id closes a question — the only thing that does. |
| delete_entry | For an entry that was wrong when it was written. One overtaken by later work is history, not an error — append instead. |
| activity_report | Today / this week / any window: durations, models, importance, decisions, dead ends, open questions. format:"markdown" is written to be pasted into a status… |
| link_files | Attach paths with their hashes to a task or a context note — the files the work touches, and the plan it follows, wherever that lives: a path outside the… |
| report_file_hashes | Hosted only: what the linked files look like on disk now. The local process does this for itself. |
| add_context | Knowledge that outlives a task; omit the project to make it account-wide. |
| get_context_note | One note in full, for the ones whose body the briefing capped and for reading past a search snippet. An entry the budget did not reach is read with get_task. |
| get_file_context | What is known about one file: the tasks that touched it with their dead ends, and the notes attached to it. Absolute or repo-relative; both find a link made on |
| session_status | Call before finishing. The tasks you changed or wrote on in this project within the last 12 hours (any status), each with whether a handoff was written since… |
| search | Across all your projects, ranked by relevance. Ask the question in words; quote a phrase to require it. Stems English and Turkish, and still matches the middle |
| get_task | One task with its log and linked files. |
| delete_project | The way back from a mistyped cwd. Takes the project and everything under it; confirm must be the slug. |
| merge_projects | The way back from one repo registered twice. Moves tasks, notes and paths into the surviving project; confirm must be the slug of the one being merged away. |
{
"mcpServers": {
"todox": {
"command": "npx",
"args": [
"-y",
"https://github.com/beydemirfurkan/todox/releases/latest/download/todox-mcp.tgz"
],
"env": {
"TODOX_TOKEN": "YOUR_TODOX_TOKEN",
"TODOX_URL": "https://www.todox.dev"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| TODOX_TOKEN | Declared in the maintainer’s client configuration. | Check documentation |
| TODOX_URL | Declared in the maintainer’s client configuration. | Check documentation |
Read, search and edit files inside allowed directories with the Model Context Protocol reference Filesystem server.
Retrieve version-aware library documentation and code examples with Context7 MCP, using resolve-library-id and query-docs.
Use Microsoft’s Playwright MCP server to navigate pages, inspect accessibility snapshots, fill forms and capture browser screenshots.
Connect GitHub MCP to repositories, issues and pull requests with GitHub’s hosted service or a locally run server.
Use the Supabase MCP server to inspect database schemas, query project data and retrieve docs through a project-scoped connection.
Search Linear issues and projects, inspect work context and manage updates through Linear’s hosted MCP server with OAuth.