Agents and MCP

How do I let Claude Code or Codex search my meeting notes?

Keep the meetings on your computer and give the agent a local, read-only way in. LokalBot records and transcribes calls on-device and includes an MCP server: turn on agent access, add it to Claude Code or Codex, and the agent can search, read, and ask about your meetings without a notetaker bot or a cloud account.

Three pieces, all on your computer

An agent can only answer “what did we decide about the launch date?” if it can reach the conversation. The usual route is a cloud notetaker: a bot or app sends the audio to a vendor, and the vendor's connector hands transcripts to the agent. A local setup replaces each step:

  1. Capture without a bot. LokalBot records your microphone and the meeting app's audio on separate tracks. Nothing joins the call.
  2. Transcribe and index on-device. Speech recognition, summaries, and the search index run on your computer and stay in a local library.
  3. Open it read-only. The bundled lokalbot-cli is both a command-line tool and an MCP server that your agent starts on your computer over stdio. It is off until you turn it on.

Set it up

  1. Install LokalBot, let the models download, and record a short test meeting.
  2. On a Mac, in Settings → External Agents, turn on Allow external agents to read your LokalBot data and keep Meetings ticked. On Windows and Linux, turn on Allow external agents to read your meeting library in Settings → Privacy & Data.
  3. In Settings → External Agents → Agent CLI on a Mac, or Settings → Advanced → Agent CLI on Windows and Linux, choose Install for your coding agent…. It installs a skill that explains the commands to agents and puts lokalbot-cli in ~/.local/bin on a Mac or Linux. On Windows it goes in %LOCALAPPDATA%\Programs\LokalBot\bin; add that folder to your PATH.
  4. Register the MCP server with your agent:
# Claude Code
$ claude mcp add lokalbot -- lokalbot-cli mcp

# Codex
$ codex mcp add lokalbot -- lokalbot-cli mcp

These commands work on Mac, Windows, and Linux once lokalbot-cli is on your PATH. Otherwise, use its full path, such as /Applications/LokalBot.app/Contents/Helpers/lokalbot-cli on a Mac. The Windows and Linux versions (alpha) have the same MCP tools as the Mac.

Claude Code and Codex can also install the LokalBot plugin, which adds a catch-up brief, recall with citations, and guided setup. The plugin doesn't start the MCP server, so keep the command above for screen memory. Other MCP clients that can start a local command, such as Cursor, use the same lokalbot-cli mcp.

What the agent can do

An agent without MCP can run the same commands in a shell. For example, lokalbot-cli search "pricing decision" prints matching meetings as JSON.

Screen memory has its own permission: on a Mac, the Screen memory box under the same switch; on Windows and Linux, a second toggle, Allow external agents to read screen memory. It grants today, the last seven days, or all retained history. Those tools return captured text and metadata, never screenshot pixels.

The Files box on a Mac, or Allow external agents to search your files on Windows and Linux, lets the agent search the folders you chose under Files with search_files, by their words. It gets each matching file's path, a short excerpt, and the passage that matched. LokalBot never changes the files.

Where your meetings go once an agent reads them

LokalBot doesn't upload your library, and its agent tools only read it, so the agent can't change or delete meetings. Changing LokalBot's settings is a separate switch, Allow external agents to change LokalBot settings, and anything that widens what LokalBot captures waits for your approval in the app. But whatever a tool returns becomes part of the agent's conversation, and Claude Code and Codex send that conversation to Anthropic or OpenAI under their own terms. Treat it like pasting the text in yourself:

FAQ

Questions about this guide

Does the agent get my audio?

No. The MCP tools return text: meeting metadata, summaries, transcripts, action items, names, and answers. They don't return audio.

Can the agent edit or delete meetings?

No. The CLI and MCP server only read your meetings; changes to them happen in the LokalBot app. Changing LokalBot's settings is a separate permission, off until you turn it on.

Does this work with other MCP clients?

Yes. Any MCP client that can start a local command can run lokalbot-cli mcp, for example Cursor. Each client's own data handling applies.

Try it locally

Meeting notes that stay on your computer by default.

Free, open source, and no account. For Mac, with Windows and Linux in alpha.

Download for macOS

Apple Silicon · macOS 15+ · or with Homebrew: brew install --cask stevyhacker/tap/lokalbot

macOS · Windows · Linux (alpha) · requirements