How do I install the recap mcp mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `RECAP_WORKSPACE_PATH` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Recap MCP Server

Recap: Your AI project manager. Plain markdown. Local-first. Open source.

Local serverstdio

What is the Recap MCP Server?

Recap: Your AI project manager. Plain markdown. Local-first. Open source.

What you get

Recap is an MCP server that gives Claude persistent memory of your ongoing projects. Job searches, side projects, learning goals, writing efforts, anything you work on over weeks or months. Your data lives as plain markdown files in a folder you own.

Local-first — your workspace is a folder of markdown files. Nothing leaves your machine
Plain markdown — open it in VS Code, Obsidian, vim, anything
Open source — MIT licensed, no vendor lock-in
Project-shaped, not blob-shaped — structured around projects, tasks, sessions, and notes, not opaque memory dumps
Eleven focused tools — no kitchen sink, no bloat

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
briefing	Run at session start. Loads workspace status, active projects, recent activity.
project_list	List projects, filter by status.
project_create	Start a new project, optionally seeded from a template.
project_brief	Load full context for one project (description, open tasks, recent sessions).
task_add	Add a task with optional priority, due date, notes.
task_list	List tasks for a project, filterable by status.
task_update	Change status, priority, due date, notes, or title.
task_delete	Remove a task.
session_log	Save a structured session entry: worked on, decisions, next steps.
quick_note	Drop a timestamped note into a project.
search	Fuzzy ranked search across the entire workspace.

How to install the Recap MCP Server

{
  "mcpServers": {
    "recap": {
      "command": "npx",
      "args": ["-y", "recap-mcp"],
      "env": {
        "RECAP_WORKSPACE_PATH": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Variable	Description	Required
RECAP_WORKSPACE_PATH	Filesystem location the server is allowed to use.	Optional

Example prompts to try

“Use Recap MCP to briefing.”
“Use Recap MCP to project list.”
“Use Recap MCP to project create.”

Frequently asked questions

Recap: Your AI project manager. Plain markdown. Local-first. Open source. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Alternatives to the Recap MCP Server

Memory

Official

Store entities, relations and observations in a local knowledge graph with the reference Memory MCP server.

Knowledge & MemoryTypeScript★ 63.0k

Notion

Official

Connect the Notion MCP server to search workspace content and work with pages and databases through Notion’s hosted OAuth service.

Productivity & Project ManagementRemoteTypeScript★ 3.3k

Xcode MCP

MCP Server for executing shell commands from MCP clients, particularly useful for Xcode-related operations

Developer Tools

TaskMaster Todoist MCP

A Model Context Protocol (MCP) server implementation for Todoist integration, specifically developed for Cursor AI. This server allows Cursor AI

Productivity & Project ManagementPython

Customermates

Native MCP access to CRM contacts, organizations, deals and tasks with user permissions.

Productivity & Project ManagementRemote

Aviasurf

Search and compare flight prices, calendars, airports, routes, and destinations with Aviasurf.