# Casefile

> Casefile is an open-source MCP server for agent tooling. Self-hosted MCP server keeping an append-only case file per task, shared across agents. It is available on Web, API, CLI and Self-hosted.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Web, API, CLI, Self-hosted
- **Repository:** https://github.com/azimov777/casefile
- **MCP Registry name:** io.github.azimov777/casefile
- **Categories:** [agent tooling](https://ai-powered.com/categories/agent-tooling)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Tools

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

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

## Alternatives

- [databasedmcp](https://ai-powered.com/mcp/databasedmcp): databasedmcp is a freemium MCP server for databases.
- [DeskPartner](https://ai-powered.com/mcp/deskpartner): DeskPartner is an open-source MCP server for agent tooling.
- [Seamless](https://ai-powered.com/mcp/seamless): Seamless is an open-source MCP server for agent tooling.
- [OpenCrawl](https://ai-powered.com/mcp/opencrawl): OpenCrawl is a freemium MCP server for agent tooling.
- [Prov](https://ai-powered.com/mcp/prov): Prov is a freemium MCP server for agent tooling.
- [Agent Context Bridge](https://ai-powered.com/mcp/agent-context-bridge): Agent Context Bridge is an open-source MCP server for agent tooling.
- [HeapFile](https://ai-powered.com/mcp/heapfile): HeapFile is a freemium MCP server for agent tooling.

---
Source: https://ai-powered.com/mcp/casefile
