Minutes

MCP server by Mat Silverstein

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

Runs locally (Runs on your machine: its page has the install command)Runs with npx

Install Minutes

Runs on your machine. Your client starts it with this command:

npx -y minutes-mcp

Needs Node.js on your computer. The setup steps below show where the command goes in each client.

  • meetings_dir optional Where meeting transcripts and voice memos are saved
  • minutes_home optional Where Minutes stores its configuration, logs, and PID files

Share this server

Opens this page, with the install command and setup steps.

mcp.tc/i/minutes

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

Show 22 more tools
  • 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

From the package’s own manifest, not a live connection, on 7 Oct 2026.

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

Set up

Every client starts Minutes on your machine with the same command. Pick yours; the page remembers your choice.

Claude Code

  1. Run this in a terminal, in your project folder:
claude mcp add --transport stdio minutes -- npx -y minutes-mcp
  1. 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
{
  "mcpServers": {
    "minutes": {
      "command": "npx",
      "args": [
        "-y",
        "minutes-mcp"
      ]
    }
  }
}
  1. 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

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

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

Needs Node.js on your computer.

VS Code

Or from a terminal:

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
{
  "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
{
  "mcpServers": {
    "minutes": {
      "command": "npx",
      "args": [
        "-y",
        "minutes-mcp"
      ]
    }
  }
}
  1. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf.

Codex

codex mcp add minutes -- npx -y minutes-mcp

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

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

Needs Node.js on your computer.

Gemini CLI

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:

{
  "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.

Embed

Show Minutes in a README or on your site. Each embed links to this page, uses the server’s own install command, and sets no cookies. How embeds work

The card, the iframe and the JSON are in English. Add ?lang=it, fr, de or es to their address for another language.

README badge

Badge preview, lightBadge preview, dark
Markdown
[![Minutes on mcp.tc](https://mcp.tc/i/minutes/badge.svg)](https://mcp.tc/i/minutes)
HTML
<a href="https://mcp.tc/i/minutes"><img src="https://mcp.tc/i/minutes/badge.svg" alt="Minutes on mcp.tc" height="20"></a>

It follows the reader’s light or dark mode. Add ?theme=light or ?theme=dark to fix it, or ?style=compact to show the mark without the word.

Website card

HTML
<script src="https://mcp.tc/w/minutes.js" async></script>

The card appears where the tag is. Add data-theme="dark" or data-size="compact" to the tag to change it. The file holds everything it needs, so it makes no other requests and sets no cookies.

iframe

HTML
<iframe src="https://mcp.tc/embed/minutes" title="Minutes on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

Use it on pages that don’t allow scripts. Add ?theme=light or ?theme=dark to the address to fix the colors.

JSON

The listing as data for your own pages and tools: name, tagline, install command, tools and the “Add to” links. Any site can read it (CORS is open).

https://mcp.tc/i/minutes.json

What each field means

AI prompt

Paste this into an AI coding assistant, such as Claude Code or Cursor, and it adds the Minutes card to your site.

Markdown
Add the mcp.tc card for Minutes, an MCP server, to my website. It is one static script: no build step, no package to install, no cookies.

Put this tag where the card should appear. The card renders right before it:

```html
<script src="https://mcp.tc/w/minutes.js" async></script>
```

To show the card somewhere else, put this placeholder there and load the same script once, for example before `</body>`. Keep the link inside: visitors without JavaScript see it.

```html
<div data-mcptc="minutes"><a href="https://mcp.tc/i/minutes">Minutes on mcp.tc</a></div>
```

Options:
- `data-theme="light"` or `"dark"` on the tag or the placeholder fixes the colors. Without it, the card follows the visitor’s light or dark mode.
- `data-size="compact"` gives a smaller card without the tagline.
- The CSS variable `--mcptc-max-width` on the placeholder or a parent sets the width (default `520px`).
- `?lang=` on the script URL sets the card’s language: `en`, `it`, `fr`, `de` or `es`.

If the site has a Content Security Policy, allow `script-src https://mcp.tc` and `img-src data:` (the icon is inline).

For a README or other Markdown docs, use the badge instead:

```markdown
[![Minutes on mcp.tc](https://mcp.tc/i/minutes/badge.svg)](https://mcp.tc/i/minutes)
```

Reference: https://mcp.tc/embed

Change history

We read the tool list in this server’s bundle manifest on GitHub every 3 hours and record what changes. Last read 8 Oct 2026, 07:23 UTC.

Follow Minutes and we’ll email you when something changes.

  1. , Automatic check

    New version 0.28.1 (was 0.28.0). Read from npm.

  2. , Automatic check

    Tracking started: 34 tools.

FAQ

Can I paste mcp.tc/i/minutes into my MCP client?

No. Minutes runs on your own computer, started by your client, so it has no web address to connect to. The quick link is the page to share; the install command is npx -y minutes-mcp.

Does Minutes need an API key?

No. It doesn’t declare any keys or environment variables. It runs with your user account’s permissions, so check what its tools can reach.

Is Minutes a remote or a local server?

Local. Your client starts it as a process on your computer with npx -y minutes-mcp, which needs Node.js.

What can Minutes do?

It has 34 tools, including start_recording, stop_recording and get_status. You can start and stop audio recording and dictation, search and read meeting transcripts and voice memos and track open and stale commitments by person.

Which clients can use it?

Any client that starts local servers: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed and others. claude.ai and ChatGPT only connect to remote servers.

Does mcp.tc track changes to Minutes?

Yes. We follow the tool list in Minutes’s bundle manifest, and its History tab shows each change we find, plus new versions and edits by its owner. Follow the listing to get an email when it changes.

Who wrote this page?

mcp.tc’s robot read Minutes’s public metadata (its package and repository pages), and an AI model drafted the text from it. A person reviews anything the checks can’t confirm. The text can still be wrong, so if you spot a mistake, use Report this listing on this page.

mcp.tc isn’t affiliated with Mat Silverstein. This page was built from Minutes’s public metadata, last checked on 7 Oct 2026, and an AI model wrote the description, so it can be wrong. Names and marks belong to their owners. Something off? Report this listing.