Recount AI Notetaker

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.

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.