# gateway [Health: Active]

**Category:** 🏢 Workplace & Productivity  
**Repository:** https://github.com/recordist-app/gateway  
**GitHub Stars:** 0  
**npm Downloads (last month):** 1276  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/gateway-8

## Description
Search and read meetings recorded by Recordist on your own computer. Loopback only.

## Tools
Capabilities this server exposes over MCP:

- **list_meetings** — List recent meetings captured by Recordist, newest first. Optional full-text filter `q`, a date range (`from`/`to`) and paging (`limit`/`offset`). Returns id, title, start time, duration, source app, status, attendees and tags.
- **get_meeting** — Fetch one meeting by id including its AI notes (summary, decisions, …), action items and markers. Use `get_transcript` for the full transcript.
- **get_transcript** — Return a meeting's transcript. `format` is one of json (segments with ms timestamps), md, srt, vtt or txt (default md). Speaker labels and timestamps are included.
- **search_meetings** — Full-text search across all transcripts and notes. Returns matching snippets with the meeting id, title, time offset and speaker so you can jump to the moment.
- **get_action_items** — List action items extracted from meetings. Filter by `meeting_id` and/or `open_only` (exclude completed items).
- **regenerate_notes** — Ask the Recordist app to write a meeting's AI notes again. They replace the current notes and open action items (Recordist keeps the earlier ones under Earlier notes; the person's own notes stay). `kind` is summary, action_items, decisions, questions, followup_email or custom; `template_id` selects a template. Requires the app to be running.
- **start_recording** — Record a meeting via the Recordist app. If the person turned on 'Allow agents to start recordings' in Recordist (Settings, Integrations), the recording starts at once. Otherwise, the safe default, Recordist shows its own record card on the person's laptop and nothing records until they answer it; the result says which happened. Requires the app to be running.
- **stop_recording** — Stop the recording under way. This ends the person's recording of their call, so only stop it when they ask you to. Transcription and notes continue in the background. Requires the app to be running.
- **add_marker** — Bookmark the current moment in the active recording with an optional label. Requires the app to be running.
- **propose_action** — Suggest an action on the person's record for them to approve in the Recordist app: draft the follow-up (kind draft_followup: meeting_id, optional template_id), mark a promise done (kind mark_promise_done: action_item_id), or export a meeting (kind export_meeting: meeting_id, optional format md|txt|srt|vtt|json). Nothing runs on this call. Recordist shows a card that says exactly what will happen and waits for the person to press Approve or Not now; a suggestion nobody answers runs out. Use `reason` to say why, in one sentence; it is shown on the card in your words. Poll `action_status` for the answer. Requires the app to be running and 'Let connected assistants suggest actions' turned on in Settings → Integrations → Recordist Agent.
- **action_status** — The status of an action you suggested with propose_action: proposed (waiting), done, failed, declined (the person said Not now) or expired (nobody answered in time). Only the status and the time of the answer come back; the card's words and any result stay in the app. Requires the app to be running.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "gateway": {
    "command": "npx",
    "args": ["-y","@recordist/gateway"]
  }
}
```

## Documentation

## What gateway does

gateway exposes Recordist's locally stored meeting data through MCP. It gives an assistant access to recent meetings, AI-generated notes, transcripts, extracted action items, markers, and full-text search results. The server communicates with the Recordist app on the local machine and listens on loopback by default.

Read access includes meeting metadata such as titles, timestamps, duration, source application, status, attendees, and tags. Agents can retrieve transcripts with speaker labels and timestamps, or request JSON, Markdown, SRT, VTT, or plain-text output. Search results include snippets, meeting identifiers, time offsets, and speakers.

The server also exposes controlled operations for active recordings and meeting follow-up. An agent can start or stop recording, add a marker, regenerate selected note types, or propose an action for approval in the Recordist app.

## How it works

The default transport is MCP over stdio, launched with `npx -y @recordist/gateway`. When Recordist is running, gateway uses the app's local API. For read operations, it can fall back to opening `recordist.db` read-only when the app is closed.

Streamable HTTP is available at `127.0.0.1:47322/mcp` with `--http`. An A2A mode is available at `127.0.0.1:47323/` with `--a2a`; it accepts JSON-RPC tasks and supports streaming subscriptions. HTTP and A2A requests require a bearer token from Recordist's local data directory or `RECORDIST_API_TOKEN`. The stdio transport does not require a token because the launching assistant is the client.

Resources are available for individual meetings and their transcripts, and the server provides prompts for summarizing a meeting, drafting a follow-up email, and conducting a weekly review.

## Setup and configuration

Install or run the package with Node.js 20 or newer:

```bash
npx -y @recordist/gateway --doctor
```

The diagnostic command checks the Recordist data directory, database, token, and app status. Install the Recordist desktop app for Mac, Windows, or Linux before using meeting data or app-dependent actions.

For Claude Desktop or Cursor, add the stdio command `npx -y @recordist/gateway` to the relevant MCP configuration. Claude Code can add it with:

```bash
claude mcp add recordist -- npx -y @recordist/gateway
```

Run `npx -y @recordist/gateway --http` for Streamable HTTP clients. Include `Authorization: Bearer <api_token>` on each HTTP request.

## Tools and capabilities

- List, filter, and page through recent meetings.
- Retrieve meeting notes, decisions, action items, markers, and transcripts.
- Search transcripts and notes using full-text queries.
- Filter action items by meeting or completion status.
- Regenerate summaries, decisions, questions, follow-up emails, or custom notes.
- Start and stop recordings and bookmark moments with markers.
- Propose follow-up drafts, promise completion, or meeting exports for approval.
- Check whether a proposed action is waiting, completed, failed, declined, or expired.

## Limitations and notes

Recording actions, markers, note regeneration, proposals, and status checks require the Recordist app to be running. Starting a recording requires either the app setting that permits agents to start immediately or a person approving Recordist's on-screen record card. Stopping a recording is destructive and should only be done when requested.

Proposed actions do not execute immediately: Recordist displays the exact operation and waits for approval. Regenerated notes replace the current notes while earlier notes are retained by Recordist; personal notes remain intact.

The gateway communicates locally, but returned meeting content goes to the connected AI assistant and may be sent to that assistant's cloud model. Regenerated notes use the AI provider configured in Recordist, which may also be a cloud service.

_Full upstream README: https://allmcps.com/mcp/gateway-8/readme_