Skip to main content
Glama

Recount MCP server

Connect Claude, Cursor, Codex, Gemini CLI, GitHub Copilot and other AI apps to Recount AI Notetaker, the desktop app that records meetings on your own computer and transcribes them there, with no bot joining the call.

Download Recount free for Windows, macOS or Linux, then connect your AI app below.

Once connected, your AI app can:

  • answer questions about past meetings ("What did Sarah say about the budget last week?")

  • search what was said across every meeting

  • follow the live transcript of the meeting you're in

  • start, stop and mute recording

  • name the speakers in a transcript

  • write your notes and meeting notes

  • turn action items into tasks on your Recount task board

Everything stays on your computer. Recount serves your meetings to AI apps only on 127.0.0.1 (this computer), and this package passes messages between your AI app and Recount without sending them anywhere else. Your AI app itself will of course read what it asks for, under its own privacy terms.

Requirements

  • Recount for Windows, macOS or Linux (free), open and signed in

  • Node.js 18 or later, for the npx setups below

Connecting AI apps is free in Recount. Recount transcribes English only.

Related MCP server: akou

Setup

Pick your AI app. Recount's Connect AI page shows the same steps.

Claude Desktop

Easiest: download recount.mcpb from the latest release and double-click it. Or click Connect on Recount's Connect AI page.

Or add this to claude_desktop_config.json (Settings > Developer > Edit Config):

{
  "mcpServers": {
    "recount": {
      "command": "npx",
      "args": ["-y", "@externalsoftware/recount-mcp"]
    }
  }
}

Claude Code

claude mcp add --transport http --scope user recount http://127.0.0.1:7891/mcp

Cursor

In ~/.cursor/mcp.json:

{
  "mcpServers": {
    "recount": { "url": "http://127.0.0.1:7891/mcp" }
  }
}

VS Code (GitHub Copilot)

In your user mcp.json (Command Palette > MCP: Open User Configuration):

{
  "servers": {
    "recount": { "type": "http", "url": "http://127.0.0.1:7891/mcp" }
  }
}

Windsurf

In ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "recount": { "serverUrl": "http://127.0.0.1:7891/mcp" }
  }
}

Gemini CLI

In ~/.gemini/settings.json:

{
  "mcpServers": {
    "recount": { "httpUrl": "http://127.0.0.1:7891/mcp" }
  }
}

OpenAI Codex

In ~/.codex/config.toml:

[mcp_servers.recount]
url = "http://127.0.0.1:7891/mcp"

Any other MCP app

Apps that connect to a URL: http://127.0.0.1:7891/mcp (Streamable HTTP). Apps that start a program: command npx, arguments -y @externalsoftware/recount-mcp.

Tools

Tool

What it does

list_meetings

Recorded meetings, newest first, with who was in each

get_meeting

One meeting: details, voices, transcript, your notes, meeting notes and screenshots

search_transcripts

Find what was said across every meeting

get_live_transcript

What has been said so far in the meeting being recorded

get_recording_status

Whether Recount is recording right now, and for how long

start_recording / stop_recording

Start or stop recording a meeting (microphone and computer audio)

mute_recording

Mute or unmute the microphone or computer audio while recording

import_recording

Import an audio or video file (.m4a, .mp3, .wav, .mp4...) as a new meeting

get_my_notes / write_my_notes

Read or write your own notes for a meeting

save_meeting_notes

Save meeting notes (Markdown) on a meeting

list_note_styles / get_note_style

The meeting-note styles you can choose from

rename_meeting / reprocess_meeting / delete_meeting

Rename, transcribe again, or delete a meeting

name_speaker / confirm_speaker / ignore_speaker / reset_speaker

Label the voices in a meeting's transcript

list_participants / add_participant / update_participant / remove_participant

The people listed as being in a meeting

list_tasks / get_task / create_task / update_task / delete_task

Your task board

add_task_column / create_project / update_project

Board columns and projects

Naming a speaker only labels that voice in that meeting's transcript; Recount doesn't save anyone's voice from it.

Troubleshooting

  • "Recount isn't open": open Recount and sign in. AI apps can only reach it while it's running.

  • Locked: if Recount's window is locked, it refuses AI requests until you unlock it.

  • Different port: if you changed Recount's port, run npx -y @externalsoftware/recount-mcp --port=1234 or set RECOUNT_MCP_URL.

Development

npm test               # tests against a stand-in Recount server
node build-mcpb.mjs    # builds dist/recount.mcpb for Claude Desktop

License

MIT for this package. Recount itself is free to download, with an optional Pro subscription: https://externalsoftware.com/recount/?utm_source=recount_mcp&utm_medium=referral

Made by External Software LLC. Recount was called Hark before November 2026.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Recordist writes notes from your calls on your laptop, with no bot in the call. Its open-source MCP server lets Claude, Cursor and other assistants search every call, open a meeting's notes and transcript, list the action items and draft the follow-up from what was said. What it returns goes to the assistant you connect. Get Recordist: https://recordist.app/download. MIT licence.
      520 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Records your calls on your own computer, transcribes them on the machine, and lets an agent start, follow, question and annotate a call while it runs. No meeting bot, no account and no cloud; the same core runs as a self-hosted transcription server.
      19
      GPL 3.0
    • A
      license
      A
      quality
      C
      maintenance
      Connects AI assistants to local workspaces for searching and reading notes, documents, objectives, and media assets, even offline. When the workspace app is open, it enables secure real-time creation and editing of notes, documents, objectives, and canvas highlighting.
      21
      10 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides read-only access to what you have dictated and what was said in your recorded meetings, so coding agents like Codex, Claude Code, Pi or LM Studio can search your local transcripts and notes.
      MIT