# Minutes MCP server

> Record, transcribe and search meetings and voice memos stored as local Markdown, from any MCP client.

- Listing: https://mcp.tc/i/minutes
- Connect: this is a local (stdio) server; install it on your machine (see Install). The listing link is a page, not an MCP endpoint.
- Type: local (stdio)
- Auth: no API key needed
- Category: [Communication & Meetings](https://mcp.tc/c/communication)
- Vendor: Mat Silverstein
- Homepage: <https://useminutes.app>
- Docs: <https://useminutes.app/for-agents>
- Repository: <https://github.com/silverstein/minutes>
- Package: npm `minutes-mcp`

## About

Minutes is an open-source, local-first conversation memory tool. It records meetings, calls, voice memos and dictation, transcribes them on-device, and saves them as Markdown files in ~/meetings/. The MCP server lets an assistant search transcripts, read meetings, track commitments, build person profiles, and run live transcription or a real-time copilot.

It runs locally over stdio through the npm package minutes-mcp, started with npx. No account or API key is needed. Restricted meetings are excluded from agent results by default. Meeting text leaves the machine only when you use a cloud assistant or summarizer. The desktop app and CLI are installed separately.

## What it can do

- Start and stop audio recording and dictation
- Search and read meeting transcripts and voice memos
- Track open and stale commitments by person
- Build person profiles and relationship maps from meetings
- Query decisions and questions extracted from meetings
- Read live transcripts during a meeting
- Run a real-time copilot and read its nudges
- Update a local knowledge base from meetings

## Tools (34)

- `start_recording`: Start recording audio from the default input device
- `stop_recording`: Stop the current recording and process it
- `get_status`: Check if a recording is in progress
- `list_processing_jobs`: List background processing jobs for recent recordings
- `list_meetings`: List recent meetings and voice memos, excluding restricted items by default
- `search_meetings`: Search meeting transcripts and voice memos, excluding restricted items by default
- `get_meeting`: Get a meeting transcript; restricted meetings return a content-free stub
- `activity_summary`: Summarize desktop context bound to one meeting
- `search_context`: Search desktop-context events bound to one meeting
- `get_moment`: Show the local desktop-context rewind for one meeting
- `get_screen_context`: Retrieve bounded, verified screenshots for one meeting
- `process_audio`: Process bounded WAV audio from the inbox or Downloads on macOS and Linux
- `add_note`: Add a timestamped note to the active recording
- `consistency_report`: Flag conflicting decisions and stale commitments
- `get_person_profile`: Build a profile of a person from policy-authorized meetings
- `research_topic`: Research a topic across policy-authorized meetings
- `start_dictation`: Start dictation mode, speech to clipboard and daily notes
- `stop_dictation`: Stop dictation mode
- `track_commitments`: List open and stale commitments, optionally filtered by person
- `relationship_map`: Rank relationships from a policy-safe graph projection
- `list_voices`: List enrolled voice profiles for speaker identification
- `confirm_speaker`: Unavailable to agents; speaker changes use the app or CLI
- `get_meeting_insights`: Query decisions, commitments and questions extracted from meetings
- `start_live_transcript`: Start a live transcript session for real-time transcription
- `read_live_transcript`: Read utterances from the active live transcript by cursor or time window
- `start_copilot`: Start the real-time copilot for a goal and observe its nudges
- `stop_copilot`: Stop the active copilot without affecting recording
- `copilot_status`: Read current copilot session and provider health
- `read_copilot_nudges`: Read copilot nudges incrementally by cursor or time window
- `ingest_meeting`: Extract facts from a meeting and update the knowledge base
- `resummarize_meeting`: Re-run the AI summary on an edited meeting, previewing by default
- `knowledge_status`: Show knowledge base configuration, adapter, people count and log entries
- `add_agent_annotation`: Append attributed agent commentary as an annotation event, allowlist-gated
- `get_agent_annotations`: Unavailable compatibility name for reading agent annotations

## Example prompts

- "What did we decide about monthly billing, and did it stick?"
- "Search my meetings for the pricing discussion last week"
- "List open commitments assigned to Alex"
- "Start recording this meeting and add a note about the budget"

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

```bash
claude mcp add --transport stdio minutes -- npx -y minutes-mcp
```

2. Start Claude Code and type `/mcp`. **minutes** should show as connected.

Add `--scope user` to make it available in every project.

### Claude Desktop

1. Open **Settings → Developer → Edit Config**. It opens `claude_desktop_config.json`. Add:

`claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "minutes": {
      "command": "npx",
      "args": [
        "-y",
        "minutes-mcp"
      ]
    }
  }
}
```

2. Save the file and restart Claude Desktop.

Needs Node.js on your computer. The file lives in `~/Library/Application Support/Claude/` on macOS and `%APPDATA%\Claude\` on Windows.

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=minutes&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1pbnV0ZXMtbWNwIl19>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

```json
{
  "mcpServers": {
    "minutes": {
      "command": "npx",
      "args": [
        "-y",
        "minutes-mcp"
      ]
    }
  }
}
```

Needs Node.js on your computer.

### VS Code

[Install in VS Code](<https://vscode.dev/redirect/mcp/install?name=minutes&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22minutes-mcp%22%5D%7D>) (opens VS Code)

Or from a terminal:

```bash
code --add-mcp '{"name":"minutes","type":"stdio","command":"npx","args":["-y","minutes-mcp"]}'
```

Or commit it to the repo in `.vscode/mcp.json`:

`.vscode/mcp.json`:

```json
{
  "servers": {
    "minutes": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "minutes-mcp"
      ]
    }
  }
}
```

Needs Node.js on your computer.

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```json
{
  "mcpServers": {
    "minutes": {
      "command": "npx",
      "args": [
        "-y",
        "minutes-mcp"
      ]
    }
  }
}
```

2. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf.

### Codex

```bash
codex mcp add minutes -- npx -y minutes-mcp
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.minutes]
command = "npx"
args = ["-y", "minutes-mcp"]
```

Needs Node.js on your computer.

### Gemini CLI

```bash
gemini mcp add minutes npx -- -y minutes-mcp
```

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients that start local servers accept this shape:

```json
{
  "mcpServers": {
    "minutes": {
      "command": "npx",
      "args": [
        "-y",
        "minutes-mcp"
      ]
    }
  }
}
```

Zed puts servers under `context_servers` in its settings, with the same `command`, `args` and `env` fields.

Needs Node.js on your computer.

## Recent changes

- 2026-10-07 16:27 UTC: New version 0.28.1 (was 0.28.0), read from npm. Source: automatic check.
- 2026-10-07 04:20 UTC: Tracking started: 34 tools read. Source: automatic check.

More on the History tab, with descriptions before and after for the newest entries: https://mcp.tc/i/minutes#history (Atom feed: https://mcp.tc/i/minutes/history.xml). It records what mcp.tc's anonymous checks saw, every 3 hours where the tool list can be read without sign-in; it is not a security review.

## Details

- Server version: 0.28.1
- Last checked: 2026-10-07
- Listed: 2026-10-07
- Updated: 2026-10-07

---
Source: https://mcp.tc/i/minutes (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report
