A CLI tool and MCP server for accessing meeting transcriptions from MacWhisper's database.
Overview
This tool provides both command-line interface and MCP (Model Context Protocol) server for MacWhisper's SQLite database. It enables users to list and export meeting transcriptions in various formats, and allows AI assistants to search and retrieve transcriptions via the MCP protocol.
A CLI tool and MCP server for accessing meeting transcriptions from MacWhisper's database.
Étoiles
14
Outils
—
Disponibilité
—
Features
CLI Features
List meetings with filtering by date range
Search meetings by content keywords, title keywords, and date range
Export transcriptions in multiple formats:
Markdown (standard or extended with metadata)
JSON (standard MacWhisper compatible or extended with metadata)
Single session export or batch export
Meeting start time estimation
MCP Server Features
Search meetings by content keywords, title keywords, and date range
Retrieve transcriptions as MCP resources or via tools (legacy mode)
Extended Markdown format with timestamps and metadata
Integration with AI assistants (e.g., Claude Desktop)
Legacy mode support for older MCP clients that don't support Resources
Installation
Homebrew
The easiest way to install on macOS is via Homebrew:
brew install dayflower/tap/mac-whisper-tool
This will install the appropriate binary for your architecture (Intel or Apple Silicon).
Pre-built Binaries
Download the latest release for your macOS architecture from the Releases page:
Intel Mac (x86_64): Download mac-whisper-tool_*_darwin_x86_64.tar.gz
Apple Silicon (ARM64): Download mac-whisper-tool_*_darwin_arm64.tar.gz
Extract and install:
# Extract the archive
tar -xzf mac-whisper-tool_*_darwin_*.tar.gz
# Move to a directory in your PATH (optional)
sudo mv mac-whisper-tool /usr/local/bin/
From Source
go build -o mac-whisper-tool
The binary will be created in the current directory.
Usage
List Meetings
Display a list of sessions from the database. This includes every session type —
recorded meetings, system-audio recordings, voice memos, podcasts, downloaded/YouTube
media, and plain imported / folder-watched files. The Type column (and type JSON
field) shows which kind each session is.
# Show the most recent 20 sessions (default)
mac-whisper-tool list
# Show all sessions in JSON format (includes the "type" field)
mac-whisper-tool list -n -1 -f json
# Filter by date range
mac-whisper-tool list -s 2025-12-01 -e 2025-12-31
# Show only imported files (folder-watcher / drag-and-drop)
mac-whisper-tool list --type imported
# Estimate meeting start times (rounds to nearest 30 minutes)
mac-whisper-tool list --estimate-start
--estimate-start - Estimate meeting start time from dateCreated and duration
-d, --db <path> - Database file path (inherited from global)
-v, --verbose - Enable verbose output to stderr (inherited from global)
At least one search criterion (keywords, title, date range, or type) must be specified.
Export Transcriptions
Export a single meeting transcription:
# Export to stdout in Markdown format (default)
mac-whisper-tool export <session-id>
# Export to a specific file
mac-whisper-tool export -o output.md <session-id>
# Export to a directory with auto-generated filename
mac-whisper-tool export -c ./exports <session-id>
# Export in JSON format (MacWhisper compatible)
mac-whisper-tool export -f json <session-id>
# Export in extended Markdown format with metadata and timestamps
mac-whisper-tool export -x <session-id>
# Export in extended JSON format with metadata and timestamps
mac-whisper-tool export -f json -x <session-id>
# Estimate start time (internal calculation only, doesn't affect output)
mac-whisper-tool export --estimate-start <session-id>
# Estimate start time with extended content
mac-whisper-tool export --estimate-start -x <session-id>
Batch Export:
Export multiple meetings at once:
# Export the latest 10 meetings
mac-whisper-tool export -c ./exports -n 10
# Export meetings from a specific date range
mac-whisper-tool export -c ./exports -s 2025-12-01 -e 2025-12-31
# Export all meetings
mac-whisper-tool export -c ./exports -n -1
URI scheme: macwhisper://localhost/session/{sessionID}
Returns extended Markdown format with timestamps and metadata
Use search_meetings tool to discover session IDs
get_meeting tool (legacy mode only): Retrieve transcription by session ID
Takes session ID as parameter
Returns extended Markdown format with timestamps and metadata
Alternative to Resources for older MCP clients
Legacy Mode
Legacy mode is designed for MCP clients that don't support the Resources feature. When running in legacy mode (--legacy):
search_meetings returns JSON-formatted results without resource links
get_meeting tool is available to retrieve transcriptions by session ID
Resources are not registered
Normal mode (default):
mac-whisper-tool mcp
# - search_meetings returns JSON + resource links
# - Resources are available
# - get_meeting tool is NOT available
Legacy mode:
mac-whisper-tool mcp --legacy
# - search_meetings returns JSON only (no resource links)
# - Resources are NOT available
# - get_meeting tool is available
Error Handling
Non-existent session ID: Error message to stderr, exit code 1
Missing database file: Error message to stderr, exit code 1
Missing output directory: Automatically created (exit code 1 on failure)
Batch export without --output-dir: Error message to stderr, exit code 1
Examples
# List the latest 5 meetings with verbose output
mac-whisper-tool list -n 5 -v
# Export a specific meeting to a file with extended content
mac-whisper-tool export -x -o meeting.md abc123def456
# Batch export all meetings from December 2025 in extended JSON format
mac-whisper-tool export -c ./exports -f json -x -s 2025-12-01 -e 2025-12-31 -n -1
# Export using a custom database path with estimated start time
mac-whisper-tool export -d /path/to/custom.sqlite --estimate-start -x -c ./output sessionID
This tool is an experimental implementation. If you need modifications or additional features, please feel free to fork this repository and customize it for your own use.
M
Mac Whisper Tool
dayflower·14 étoiles·
A CLI tool and MCP server for accessing meeting transcriptions from MacWhisper's database.
Pas encore de liste d'outils. Les serveurs distants en obtiennent une après le premier contrôle d'état.
FAQ
Questions
Comment installer Mac Whisper Tool ?
Copiez sur cette page la configuration stdio pour Cursor, Claude Desktop, Claude Code ou VS Code. Elle utilise l'installation de l'éditeur, pas un proxy PlugMCP.
Mac Whisper Tool nécessite-t-il une clé API ?
Aucune variable d'environnement requise n'est indiquée sur cette fiche.
Quel transport Mac Whisper Tool utilise-t-il ?
Mac Whisper Tool s'exécute en local via stdio.
Quand Mac Whisper Tool a-t-il été vérifié pour la dernière fois ?
Dernière vérification : 2026-10-28. A CLI tool and MCP server for accessing meeting transcriptions from MacWhisper's database.