# gateway

Exposes local Recordist meeting notes and transcripts to desktop AI coding tools. Lets your assistant search call history and collect action items.

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

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `RECORDIST_API_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env RECORDIST_API_URL=<RECORDIST_API_URL> --transport stdio recordist-app-gateway -- npx -y @recordist/gateway
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add recordist-app-gateway --env RECORDIST_API_URL=<RECORDIST_API_URL> -- npx -y @recordist/gateway
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "recordist-app-gateway": {
            "command": "npx",
            "args": [
                "-y",
                "@recordist/gateway"
            ],
            "env": {
                "RECORDIST_API_URL": "<RECORDIST_API_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "recordist-app-gateway": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@recordist/gateway"
            ],
            "env": {
                "RECORDIST_API_URL": "<RECORDIST_API_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e RECORDIST_API_URL=<RECORDIST_API_URL> recordist-app-gateway npx -y @recordist/gateway
```
Replace <…> with your own values

## When to use it
- 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
- 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

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44908
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22082
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12826
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9623
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2330
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2071

## Other versions with the same name
- [gateway · mcprating](https://affpapa.org/en/nevibecode/mcp/gateway.md) — ★ 1

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