Connect AI clients to your local meeting recordings to search transcripts, manage tasks, and control recording status.
Also known as External-Software/recount-mcp, recount-mcp, @externalsoftware/recount-mcp
- Stars
- 0
- Tools
- 8
- Downloads, 30 days
- 324
- Latest version
- 1.0.0
- Last commit
- Nov 11, 2026
- License
- MIT
What is Recount AI Notetaker MCP?
Recount AI Notetaker connects AI clients to your local meeting recordings to search transcripts, manage tasks, and control recording status. It exposes 8 tools, such as list_meetings, get_meeting, search_transcripts.
Summary generated from the project's README
About Recount AI Notetaker MCP server
Recount AI Notetaker connects AI clients like Claude Desktop, Cursor, and GitHub Copilot to your local meeting recordings. This server allows your AI to interact with the Recount desktop application, which records and transcribes meetings directly on your computer without using a bot. Because the connection happens via 127.0.0.1, your data stays local to your machine.
Users can manage their recording workflow through tools like start_recording, stop_recording, and mute_recording. The server provides access to meeting details, transcripts, and speaker identification. It also integrates with a task board, enabling the creation and management of action items. To use this, you must have the Recount app open and signed in on Windows, macOS, or Linux, along with Node.js 18 or later for npx setups.
This tool is designed for developers and professionals who want to use AI to search through past meeting transcripts, follow live transcripts, or automate meeting notes. It supports English transcription and allows for importing existing audio or video files to be processed as new meetings.
What you can do with it
- 1Search meeting historyAsk your AI client to find specific information mentioned in previous conversations.
- 2Manage meeting recordingsDirect your AI to control the recording process including starting, stopping, or muting audio.
- 3Automate task managementConvert spoken action items from your meetings into organized tasks on a board.
- 4Analyze live discussionsHave your AI follow along with the text of a meeting as it is happening.
Written from the project's README. Every use case is checked against a quote from it.
How to install Recount AI Notetaker MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Recount AI Notetaker MCP in Claude Code
$ claude mcp add recount-mcp -- npx -y @externalsoftware/recount-mcpInstall Recount AI Notetaker MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"recount-mcp": {
"command": "npx",
"args": [
"-y",
"@externalsoftware/recount-mcp"
]
}
}
}Install Recount AI Notetaker MCP in VS Code
.vscode/mcp.json
{
"servers": {
"recount-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@externalsoftware/recount-mcp"
]
}
}
}Install Recount AI Notetaker MCP in VS Code CLI
$ code --add-mcp '{"name":"recount-mcp","type":"stdio","command":"npx","args":["-y","@externalsoftware/recount-mcp"]}'Install Recount AI Notetaker MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"recount-mcp": {
"command": "npx",
"args": [
"-y",
"@externalsoftware/recount-mcp"
]
}
}
}Install Recount AI Notetaker MCP in Codex
$ codex mcp add recount-mcp -- npx -y @externalsoftware/recount-mcpInstall Recount AI Notetaker MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.recount-mcp] command = "npx" args = ["-y", "@externalsoftware/recount-mcp"]
Install Recount AI Notetaker MCP in Gemini CLI
$ gemini mcp add -s user recount-mcp npx -- -y @externalsoftware/recount-mcpInstall Recount AI Notetaker MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"recount-mcp": {
"command": "npx",
"args": [
"-y",
"@externalsoftware/recount-mcp"
]
}
}
}Recount AI Notetaker MCP tools 8
Detected from the READMElist_meetingsget_meetingsearch_transcriptsget_live_transcriptget_recording_statusmute_recordingimport_recordingsave_meeting_notes
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableexternal-software/recount-mcp is public and reachablegithub.com/external-software/recount-mcp ↗Pass
- Package names this repository as its source@externalsoftware/recount-mcp names external-software/recount-mcp as sourcenpmjs.com/package/@externalsoftware/recount-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-11github.com/external-software/recount-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @externalsoftware/recount-mcpPass
- No critical advisory in the package or its dependenciesthe package checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model8 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubRecount 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
npxsetups 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=1234or setRECOUNT_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.
Recount AI Notetaker MCP questions
How do I add Recount AI Notetaker MCP to Claude Code?
Run claude mcp add recount-mcp -- npx -y @externalsoftware/recount-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Recount AI Notetaker MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Recount AI Notetaker MCP provide?
It exposes 8 tools, including list_meetings, get_meeting, search_transcripts, get_live_transcript, get_recording_status.
Does Recount send my meeting data to the cloud?
No, everything stays on your computer. Recount serves meetings to AI apps locally via 127.0.0.1.