Todox MCP Server

Working memory for developers and their agents. Not a checklist - a log your next session can actually resume from. Its 15 documented tools cover context, task, report, file. It is available as a remote MCP endpoint.

Teams that work with context, task and report and want a hosted endpoint instead of running a local process. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-15 · ★ 2 · #153 OF 168 MAINTAINED DATABASE · VERIFIED 2026-09-18

MIT · TypeScript servers · how we verify → /methodology

01 · Install Todox

before you install - you'll need

Set TODOX_TOKEN, TODOX_URL before connecting.

Claude Code

claude mcp add beydemirfurkan-todox --transport http https://www.todox.dev/api/mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "beydemirfurkan-todox": {
      "url": "https://www.todox.dev/api/mcp"
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

https://www.todox.dev/api/mcp

transport: streamable-http

endpoint alive - authentication required · probed 2026-09-18

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as remote - your agent's requests go to www.todox.dev

endpoint auth requires authentication - rejected our unauthenticated MCP initialize

repo age created 2026-08-09 - young repo, little track record yet

license MIT - declared in the repository

registry namespace io.github.beydemirfurkan is GitHub-verified and matches the repo owner

03 · What Todox can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 15 documented tools spanning context, task, report, file, including get_context, create_task, update_task, log_entry.

Capability map

Tools grouped from the project's README - what Todox lets an agent do.

Context

4 tools - e.g. Call this first. Standing rules, project decisions and gotchas, every open task with its decisions, dead ends, questions, files and last handoff - plus stale-fi; Knowledge that outlives a task; omit the…

get_context · add_context · get_context_note · get_file_context

Task

3 tools - e.g. 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 re; Status, title, body, priority. Moving to…

create_task · update_task · get_task

delete

2 tools - e.g. For an entry that was wrong when it was written. One overtaken by later work is history, not an error - append instead.; The way back from a mistyped cwd. Takes the project and everything under it…

delete_entry · delete_project

Log

1 tool - e.g. Append one of the five kinds. answers_entry_id closes a question - the only thing that does.

log_entry

Activity

1 tool - e.g. Today / this week / any window: durations, models, importance, decisions, dead ends, open questions. format:"markdown" is written to be pasted into a status upd

activity_report

Link

1 tool - e.g. Attach paths with their hashes to a task or a context note. Safe to call again for the same file.

link_files

Report

1 tool - e.g. Hosted only: what the linked files look like on disk now. The local process does this for itself.

report_file_hashes

read & search

1 tool - e.g. 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

search

Latest releases

v0.1.3 · 2026-09-15

Install the stdio MCP server without cloning anything. There is no · npm package; these URLs are the distribution. · bash · always the newest release · npx · or pin this one · npx · The hosted server needs none of this…

v0.1.2 · 2026-09-13

Install the stdio MCP server without cloning anything. There is no · npm package; these URLs are the distribution. · bash · always the newest release · npx · or pin this one · npx · The hosted server needs none of this…

v0.1.1 · 2026-08-30

Install the stdio MCP server without cloning anything: · bash · npx todox-mcp # once this is on npm · npx · The hosted server needs none of this - point any MCP client at · for the one thing a…

04 · Who maintains Todox

todox is maintained by beydemirfurkan. It's the only MCP server we track from this author; the repo dates to Aug 2026.

05 · Facts

category
database - ranked #153 of 168 actively-maintained database servers as of 2026-09-18.
release cadence
4 releases in the last 90 days (latest 2026-09-15)
registry
io.github.beydemirfurkan/todox (active, first published 2026-08-16 · 2 versions)

06 · Todox FAQ

Is Todox still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-15 and it shipped 4 releases in the last 90 days. We re-verify nightly.

What can Todox do?

An agent gets 15 documented tools spanning context, task, report, file, including get_context, create_task, update_task, log_entry.

How do I install Todox?

Run `claude mcp add beydemirfurkan-todox --transport http https://www.todox.dev/api/mcp`. The README documents 2 environment variables (TODOX_TOKEN, TODOX_URL) to set first. Set TODOX_TOKEN, TODOX_URL before connecting. You can also paste the ready-made client config above.

Does Todox require authentication?

Yes - when we probed the endpoint on 2026-09-18, it rejected an unauthenticated MCP initialize; you'll need credentials to connect.

07 · Alternatives to Todox