Skip to content
MCP server

Casefile

Self-hosted MCP server keeping an append-only case file per task, shared across agents

Casefile is an open-source MCP server for agent tooling. It is available on Web, API, CLI and Self-hosted.

Pricing
Open source
Platforms
Web, API, CLI
Version
0.17.1
Listing updated

Similar MCP servers

About Casefile

The README describes Casefile as a place where agents record decisions, failed attempts, findings and open questions for each task. When a session ends, the next agent, a different vendor's agent, or a person reads the latest summary and open questions and continues from there, without re-discovering the code or repeating dead ends.

It runs as a self-hosted MCP server in Docker with a web board that shows what each agent is doing. Tasks are grouped under projects and areas, and entries are typed and append-only, so a correction is a new entry that points back at the old one. The server exposes tools for creating and moving tasks, filing summaries, verdicts and questions, linking tasks, and managing files and participants. It deliberately does not start agents, run timers or assign work.

The README says it is aimed at people whose agents work on tasks spanning more than one session. It is made for Claude Code, and states that Codex, Cursor and other MCP clients connect the same way. Sign-in and sharing across a team are optional and require the installation to be placed on a server with TLS.

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

get_task
Returns everything about one task in a single call.
search_tasks
Searches tasks by query string or separate conditions.
create_task
Creates a task in backlog, optionally as a child of a parent task.
update_task
Changes the given fields of a task.
transition
Moves a task to another status along the transition table.
close_task
Files entries, verdicts and the final summary and moves the task to done.
read_entries
Returns entry bodies of one task's case in number order.
add_summary
Files a handover summary for a case.
add_entry
Files a decision, attempt, finding, artifact, remark or note.
ask
Files a question to registry participants in a discussion.
add_verdict
Files the outcome of one review check.
link
Links two tasks or attaches a task to a discussion.

What it does

Per-task case files
Each task gets an append-only log of decisions, attempts, findings and questions.
Handoff summaries
A new session reads the latest summary, open questions and an index before continuing.
Live web board
A board and task pages show agent activity and let people answer questions and leave remarks.
Verdict-gated closing
A task cannot close without a summary and a passed verdict on each check.
Optional team sign-in
Network mode adds email and password accounts, with OAuth for agent clients behind TLS.
Automatic self-updates
An updater service checks for new tagged releases and can roll back a failed start.

Good for

  • Resuming a multi-session coding task with a fresh agent that reads the previous summary
  • Handing a task from one agent vendor to another without re-reading the whole repository
  • Recording failed approaches so an agent does not retry them in a later session
  • Letting a team see and answer open questions from the agents working on their tasks

Pricing

Open source

Free to use, MIT-licensed, self-hosted.

Casefile FAQ

What does Casefile cost?

The README says it is free to use and is MIT-licensed.

Does Casefile run on my own machine?

Yes. It runs locally in Docker and listens on localhost by default; the README notes that nothing leaves the computer unless network mode is enabled.

Which agents can connect?

The README says it is made for Claude Code and that Codex, Cursor and other MCP clients connect the same way, with OAuth for clients that support it and an agent key for others.

Does Casefile assign or schedule work?

No. The README states it assigns and schedules nothing and does not start agents or move tasks by itself.

What are the best alternatives to Casefile?

The closest alternatives to Casefile are databasedmcp, DeskPartner, Seamless, OpenCrawl and Prov.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.

How AIPoweredBot checks servers