# minutes

minutes records and transcribes meetings locally, then lets an agent search the records you choose to share. Use it to bring decisions from past conversations back into your work.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 1567
- Author: silverstein
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/silverstein/minutes
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/minutes

## What it does

The MCP server lets an agent search local meeting records. minutes can also capture calls, voice memos, and dictation; audio processing happens on your device. Records are Markdown files with YAML metadata in `~/meetings/`, readable in Obsidian or searchable with grep.

Connect it to Claude Code with the install command below. The server runs through `npx -y minutes-mcp` and searches the meeting files you allow the agent to access. If you send context to a cloud assistant or summarizer, that text goes to the provider.

Transcription stays on your device. Sharing text with a cloud AI is a separate step, which matters when a conversation contains sensitive details.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add minutes -- npx -y minutes-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add minutes -- npx -y minutes-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "minutes": {
            "command": "npx",
            "args": [
                "-y",
                "minutes-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "minutes": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "minutes-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add minutes npx -y minutes-mcp
```

## When to use it
- retrieve a decision from an earlier meeting
- search transcripts for project context
- save meeting records as Markdown with metadata
- transcribe a voice memo or dictation

## Example prompts
- Search my meeting notes for what we decided about monthly billing.
- Record this meeting, then find the decisions in its transcript.
- Look through my meeting records for context on this project.

## Similar
- [lark-minutes](https://affpapa.org/en/nevibecode/skills/lark-minutes.md) — skill · 467000 installs
- [meeting-minutes](https://affpapa.org/en/nevibecode/skills/meeting-minutes.md) — skill · 9881 installs
- [meeting-minutes-taker](https://affpapa.org/en/nevibecode/skills/meeting-minutes-taker.md) — skill · 1500 installs
- [board-minutes](https://affpapa.org/en/nevibecode/skills/board-minutes.md) — skill · 629 installs
- [Automated Text Typing Every 5 Minutes with Python](https://affpapa.org/en/nevibecode/prompts/automated-text-typing-every-5-minutes-with-python.md) — prompt · ★ 174597
- [faster-whisper](https://affpapa.org/en/nevibecode/skills/faster-whisper.md) — skill · 1800 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md