How to connect Walkie to Claude, ChatGPT, Gemini and Grok

Connect Claude, ChatGPT, Gemini, Codex or Grok to your Walkie meetings, so you can ask them what was said, what was decided and who said it. Pick the app you use below and follow three steps — about two minutes, and Walkie handles the rest. Needs Walkie Work or above. Everything is read-only: an agent can search and read your meetings, never change, share or delete them.

Experimental. Requires Walkie Work or above, on macOS. The tools may change between releases, so an agent wired up today may need rewiring later.

Last updated

Which agent are you using?

Pick one and follow the steps — Walkie works out how to reach it. Using something else? The last tab covers any client that speaks MCP.

Connect Claude Desktop

Runs on this Mac

  1. Open Walkie → Settings → MCP

    Switch on the MCP server. It needs the Walkie Work plan or above.

  2. Press Connect next to your app

    Walkie adds itself to that app's settings for you, pointing at wherever Walkie is installed. Anything else you have connected to that app is left alone.

  3. Restart the app and ask a question

    Apps only check their settings when they start, so quit and reopen. Then ask it something only your meetings would know, like "what did we decide about pricing last week?"

Prefer to edit the settings yourself?

Where: Settings → Developer → Edit Config, which opens claude_desktop_config.json

{
  "mcpServers": {
    "walkie": {
      "command": "/Applications/Walkie.app/Contents/MacOS/walkie",
      "args": ["--mcp-serve"]
    }
  }
}

Quit and reopen Claude Desktop afterwards — it reads the config once, at launch.

Where do my meetings actually go?

You do not have to choose — your agent decides for you. It is worth knowing what changes, because one of them reads straight from your disk, without your meetings passing through our servers.

Runs whereSeesNeeds
Apps on this MacClaude Desktop, Claude Code, Codex CLI, Gemini CLI — anything that can start a process on your machine.Reads Walkie's database on your disk directly. Every meeting you have, including ones you never synced.Walkie Work plan · Walkie installed
Apps on the webChatGPT and any hosted agent that cannot start anything on your Mac.Reads the meetings already synced to your Walkie account — not the ones that only exist on your machine.Walkie Work plan · meetings synced

You approve each agent, by name

Adding the connector opens a Walkie page that names the agent and shows exactly what it will be able to read. Approve it and you are done — there is nothing to copy, and you can take that access away later without touching the others. If your client cannot do that yet, generate a link in Settings → MCP and paste that instead; treat it like a password. Either way, you revoke from Settings → MCP.

What can the agent actually do?

It can search across every meeting you have recorded, then open one and read it in full — the notes, the action items, who was there, and the transcript with speakers labeled. Those are the same two moves whichever way it connected. The exact tool names, arguments and return shapes are in the MCP docs article.

What it deliberately will not do

It answers questions, it does not hand over your archive

By default an agent can search and read what it finds, but cannot list your archive or page past the first results — it answers questions rather than walking the corpus. Handing over everything is a separate switch in Walkie, off until you turn it on.

Read-only

Nothing an agent calls can delete a meeting, edit a transcript, change a setting, or share anything. The tools only read.

Off by default

Access ships switched off, per machine and per account. Cancelling or downgrading switches it back off rather than leaving it quietly running.

Troubleshooting

The client says the server exited immediately
Why: The MCP server switch is off, or the account is not on a plan that includes it. Fix: Run /Applications/Walkie.app/Contents/MacOS/walkie --mcp-serve directly in a terminal. It prints exactly why it refused. Switch it on in Settings → MCP, on the Walkie Work plan or above.
No such file or directory
Why: The file inside the Walkie app is lowercase walkie, even though the app itself is Walkie.app. It is an easy letter to get wrong. Fix: Copy the path exactly as shown — /Applications/Walkie.app/Contents/MacOS/walkie — rather than typing it out. Also check Walkie is in your Applications folder, not still in Downloads.
The agent connects but finds nothing
Why: Meetings still recording are excluded, and search matches literal words rather than meaning. Fix: Stop the meeting first, then search for a phrase somebody actually said rather than a paraphrase of the topic.
The server worked, then stopped
Why: Cancelling or downgrading below the plan that includes MCP switches the server off, on purpose. Fix: Check the plan on your account. The switch reflects entitlement, not a setting you can override.
An agent should not have access any more
Why: Approvals last until you withdraw them. Fix: Revoke it in Walkie under Settings → MCP. Each agent holds its own credential, so revoking one does not disturb the others.

Still stuck? Run /Applications/Walkie.app/Contents/MacOS/walkie --mcp-serve in a terminal. It refuses out loud, with the reason — which is faster than reading an agent’s logs.

Frequently asked questions

Does it work when Walkie is closed?
Yes, for the local server. Your agent launches its own short-lived walkie --mcp-serve process that reads the database on disk — the Walkie app does not need to be running.
Why does ChatGPT show five tools instead of three?
ChatGPT's connector surface looks for tools literally named search and fetch, so the endpoint answers to those as well as search_meetings, get_meeting and list_meetings. The aliases run the same code as the real names.
How do I revoke an agent's access?
In Walkie, go to Settings → MCP. Revoke the agent you want to cut off, or switch the whole server off. Either takes effect immediately.
Can I connect apps on my Mac and ChatGPT at the same time?
Yes. They are independent, and read the same meetings. Turning one off does not affect the other.
Do I need to restart Walkie after switching the server on?
No. The switch writes a flag that each new walkie --mcp-serve process reads at launch, so the next time your agent connects it picks up the change. You do need to restart the AI client itself after editing its config, because it reads that once, at startup.

Every meeting you have makes your agents smarter

Download WalkieAbout Walkie MCP