# Breadcrumbs

> Personal project manager that syncs GitHub repos and tracks coding activity through CLAUDE.md / CLAUDE_LOG.md snapshots. Ships with a Model Context Protocol (MCP) server so AI assistants can read the kanban board, attach card notes, and write project documentation directly.

Breadcrumbs is a self-hostable kanban + project context tool aimed at solo developers and small teams that work alongside AI coding assistants. Activity logs are pulled from each project's `CLAUDE_LOG.md`. AI agents (Claude Code, Codex) connect over MCP using project-scoped API keys.

## Docs

- [Sign in](https://breadcrumbs.dev/login): existing accounts
- [Sign up](https://breadcrumbs.dev/signup): create a new account

## Source

- [GitHub repository](https://github.com/xie-andy/breadcrumbs): source, deployment notes, MCP server implementation

## MCP

- Endpoint: `https://breadcrumbs.dev/mcp` (Streamable HTTP, JSON-RPC) and `https://breadcrumbs.dev/mcp/sse` (Server-Sent Events fallback)
- Auth: `Authorization: Bearer bc_<project_api_key>` — keys are minted per-project from the project Settings tab
- Tools include `get_project_overview`, `get_kanban_board`, `create_card`, `update_card`, `add_note`, `read_documentation`, `write_documentation`, `delete_documentation`, `log_activity`, and structured plan/verification helpers