gateway · recordist-app — Claude Code MCP server: what it does, how to install
Exposes local Recordist meeting notes and transcripts to desktop AI coding tools. Lets your assistant search call history and collect action items.
claude mcp add --env RECORDIST_API_URL=<RECORDIST_API_URL> --transport stdio recordist-app-gateway -- npx -y @recordist/gatewayWhat gateway does
The gateway acts as an MCP bridge to your local Recordist setup. Read tools fetch meeting data even when the desktop client is shut down: the server attempts to hit the local API first and falls back to inspecting recordist.db directly in read-only mode. Assistants can run FTS5 search queries across past conversations, inspect summaries, and extract transcripts in markdown, json, srt, vtt, or plain text.
Mutating actions depend strictly on the desktop client running in the background. Starting and stopping a recording, appending timeline markers, or asking to regenerate notes will error out if the app process is missing. Starting an active recording also fails unless you explicitly enable the agent recording permission inside the application settings.
All internal traffic stays on the 127.0.0.1 loopback address by default. Using the standard stdio transport requires no authentication tokens, while HTTP transport modes demand a Bearer token sourced from the local api_token file.
What it helps with
- run full-text search across past call transcripts and notes
- collect pending action items from recorded discussions
- extract meeting dialogues into SRT or Markdown formats
- trigger and bookmark local audio recordings via assistant tools
Example prompts for the agent
- Show all open action items from my meetings recorded yesterday
- Search my meeting transcripts for mentions of database migration blockers
- Fetch the transcript of the latest design sync as markdown
How to install gateway
Platform CLI
claude mcp add --env RECORDIST_API_URL=<RECORDIST_API_URL> --transport stdio recordist-app-gateway -- npx -y @recordist/gatewayReplace <…> with your own values
Platform CLI
codex mcp add recordist-app-gateway --env RECORDIST_API_URL=<RECORDIST_API_URL> -- npx -y @recordist/gatewayReplace <…> with your own values
Config file
{
"mcpServers": {
"recordist-app-gateway": {
"command": "npx",
"args": [
"-y",
"@recordist/gateway"
],
"env": {
"RECORDIST_API_URL": "<RECORDIST_API_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"recordist-app-gateway": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@recordist/gateway"
],
"env": {
"RECORDIST_API_URL": "<RECORDIST_API_URL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e RECORDIST_API_URL=<RECORDIST_API_URL> recordist-app-gateway npx -y @recordist/gatewayReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about gateway
How to install gateway in Claude Code?
Run claude mcp add gateway -- npx -y @recordist/gateway in your command line. Node.js version 20 or higher is required.
What does gateway do?
It gives connected AI assistants tools to browse, search, and manage local meeting recordings and generated action items stored by Recordist.
Can it read meetings when Recordist is closed?
Yes, reading calls, notes, and transcripts still works because the gateway opens the local recordist.db file directly in read-only mode.
Similar MCP servers
All MCP servers for Notes, tasks and projects →gateway by other authors comes first.
