How do I connect Todox MCP Server to Claude?

Run `claude mcp add todox -- npx -y https://github.com/beydemirfurkan/todox/releases/latest/download/todox-mcp.tgz` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.

Is Todox MCP Server free?

The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.

What can Todox MCP Server do?

Todox MCP Server documents 15 tools to the agent, including activity_report, add_context, create_task. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

Todox

Unclaimed

by beydemirfurkan

Working memory for developers and their agents — an agent-first task log with decisions, dead ends and handoffs, reachable over MCP

Set up this server

Compare servers My Stack

01 / Choose your client

02 / Before you connect

Authentication is not specified. Check the project instructions before connecting.

Install the runtime required by the project and make it available to your client.

Project instructionsEnvironment variable names (optional)

Use names from the project instructions, separated by commas. Enter names only, never secret values.

03 / Add the configuration

Source: generated from public install instructions

claude mcp add --transport stdio 'todox' -- 'npx' '-y' 'https://github.com/beydemirfurkan/todox/releases/latest/download/todox-mcp.tgz'

Run in your terminal after replacing any placeholders.

04 / Check it in your client

Open your client’s MCP settings and confirm the server connects and lists its tools. A copied configuration does not confirm a working connection.

ai-agentsclaudedeveloper-toolsmcpmodel-context-protocolnextjspostgresself-hosted

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

15 of 15 tools

Documented tools (15)

From project documentation. A server handshake does not verify each tool’s description or behavior.

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 update.

add_context

Knowledge that outlives a task; omit the project to make it account-wide.

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 reporoot or repourl. The receipt returns the task path and body length without echoing the body.

delete_entry

For an entry that was wrong when it was written. One overtaken by later work is history, not an error — append instead.

delete_project

The way back from a mistyped cwd. Takes the project and everything under it; confirm must be the slug.

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 stale-file warnings. Resolves a project from a slug, a name, or any path inside it. Capped in rows and in bytes, never truncated: every record keeps

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 gettask.

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 another machine.

get_task

One task with its log and linked files.

link_files

Attach paths with their hashes to a task or a context note. Safe to call again for the same file.

log_entry

Append one of the five kinds. answersentryid closes a question — the only thing that does.

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.

report_file_hashes

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

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 of an identifier. Words that only one of the two languages treats as noise are dropped, so a question does not match every record containing

update_task

Status, title, body, priority. Moving to doing/done is where durations come from.

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about Todox MCP Server

How do I connect Todox MCP Server to Claude?: Run `claude mcp add todox -- npx -y https://github.com/beydemirfurkan/todox/releases/latest/download/todox-mcp.tgz` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.
Is Todox MCP Server free?: The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can Todox MCP Server do?: Todox MCP Server documents 15 tools to the agent, including activity_report, add_context, create_task. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.