# Meetings List

> List recent meetings and voice memos. Use when the user asks "what meetings did I have", "show my recent recordings", "any meetings today", "list my voice memos", or wants an overview of their meeting history. Also use when they need to find a specific meeting by browsing rather than searching.

- Skill: `flonat/meetings-list` (Agent Skill)
- Install (CLI): `npx skillmds@latest add flonat/meetings-list`
- Raw SKILL.md: https://api.skillmd.com/api/skills/flonat/meetings-list/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: flonat (https://skillmd.com/u/flonat)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/flonat/meetings-list

---


# meetings-list

Show recent meetings and voice memos, sorted newest-first.

## Usage

```bash
# List last 10 recordings (default)
minutes list

# Show more
minutes list --limit 20

# Only voice memos
minutes list -t memo

# Only meetings
minutes list -t meeting
```

## Output

Human-readable list to stderr, JSON array to stdout. Each entry has:
- `title`, `date`, `content_type`, `path`

To read a specific meeting's full transcript, use `Read` on its `path`.

## Gotchas

- **Returns nothing on first use** — If `~/vault/meetings/` doesn't exist yet or has no `.md` files, list returns an empty array. This is normal before the first recording.
- **JSON goes to stdout, human-readable to stderr** — If you pipe the output (e.g., `minutes list | jq`), you get JSON only. The human-readable table goes to stderr.
- **In-progress recordings don't appear** — List only shows completed, processed recordings. Use `minutes status` to check if something is currently recording.
- **Sorted by date in frontmatter, not file modification time** — If you manually edit a meeting file, it won't change its position in the list.