---
title: "Mumr Plugin for Claude Code and Codex — Mumr"
description: "Tell Claude Code or Codex to start or stop a Mumr recording on your Mac, and ask about the meetings Mumr saved there. Two skills, no server, no settings."
canonical: "https://mumr.app/plugin"
language: "en-GB"
last-updated: "2026-11-08T00:32:54+00:00"
source: "https://mumr.app — Markdown rendition of the HTML page at `canonical`"
---

Plugin · Claude Code · Codex · on your Mac

# Start Mumr from your assistant

Tell Claude Code or Codex to start recording, and Mumr starts on your Mac. Ask what you decided last week, and it answers from the meetings Mumr saved there.

The plugin is two skills, written as plain instructions. It adds no server, no program and no settings.

[Download for Mac](https://mumr.app/download)

On the Mac App Store · macOS 15 or later

What the plugin does

## Record, stop and ask, in your own words

Your assistant runs one short command on your Mac, and the Mumr app does the rest.

-   Record
    
    “Start recording this meeting.”
    
    Mumr starts recording on your Mac, as if you had clicked Record.
    
-   Stop
    
    “Stop the recording.”
    
    Mumr stops and saves the meeting to your recordings folder, as it does when you press Stop.
    
-   Ask
    
    “What did we decide with Acme last time?”
    
    Your assistant reads the meeting list and summaries Mumr wrote to your folder, and answers from them.
    

Where it works

## It needs an assistant that runs commands on your Mac

The plugin works where your assistant can run commands on the Mac that has Mumr: Claude Code in Terminal, the Code tab of the Claude desktop app, the Codex CLI, and Codex threads that run locally in the ChatGPT desktop app.

It does not work in an ordinary claude.ai or ChatGPT chat, or in a cloud session. Those run on the vendor's servers, which cannot reach your Mac.

In Claude chat

## In Claude chat: the Mumr connector

In an ordinary Claude chat, use the Mumr connector instead of the plugin. When you ask, Claude shows a card with one button, and your click opens the Mumr app on this Mac.

-   Record
    
    Start recording in Mumr
    
    Click it, and Mumr starts recording on your Mac.
    
-   Stop
    
    Stop recording in Mumr
    
    Click it, and Mumr stops the recording on your Mac.
    
-   Window
    
    Open Mumr
    
    Click it, and the Mumr window comes to the front on your Mac.
    

A card does nothing until you click it. The card cannot see your Mac, so after the click it says it asked Mumr, and Mumr's live panel shows whether it is recording.

No meeting data leaves your Mac. The connector has no access to audio, transcripts or summaries, takes no input, and shows the same card to everyone.

[How the connector handles requests: privacy policy, section 7a.](https://mumr.app/privacy#mcp-connector)

It needs Mumr for Mac, and Claude open on the same Mac, in a browser or the Claude desktop app.

1.  In Claude, open Customize, then Connectors. Click + Add, then Add custom connector.
2.  Name it Mumr, paste this address, and under Authentication choose No sign in.
    
    ```
    https://mumr.app/mcp
    ```
    
3.  In a new chat, ask Claude to record this meeting with Mumr, and click the button on the card. Claude asks before it opens a link from a custom connector; allow it.

Record only when you mean to, and tell the others in the meeting that they are being recorded.

A listing in Claude's connector directory is pending. Until it is listed, add Mumr as a custom connector as shown above.

Install

## Add it to the app you use

Install Mumr for Mac first. Then pick your app below; one is enough.

-   ### Claude desktop app
    
    Open Plugins. In older versions it sits under Customize. Click Add, choose Add marketplace, then Add from a repository, and paste this:
    
    ```
    https://github.com/mumr-app/mumr-plugin
    ```
    
    Click Sync, open Mumr and install it. Then ask in the Code tab.
    
    Claude's help pages list plugins as a feature of paid plans.
    
-   ### Claude Code in Terminal
    
    Run this in Terminal:
    
    ```
    claude plugin install mumr --marketplace mumr-app/mumr-plugin
    ```
    
    The Terminal command needs Claude Code 2.1.292 or later. Already in a Claude Code session? Type this instead. It needs Claude Code 2.1.275 or later:
    
    ```
    /plugin install mumr --marketplace mumr-app/mumr-plugin
    ```
    
    On an older version, run these two lines in Terminal:
    
    ```
    claude plugin marketplace add mumr-app/mumr-plugin
    ```
    
    ```
    claude plugin install mumr@mumr
    ```
    
-   ### Codex CLI
    
    Run these two lines in Terminal:
    
    ```
    codex plugin marketplace add mumr-app/mumr-plugin
    ```
    
    ```
    codex plugin add mumr@mumr
    ```
    
    Then start a new Codex session.
    
-   ### ChatGPT desktop app
    
    Mumr is not listed in the ChatGPT plugin directory. Until it is, run the first Codex line above in Terminal, restart the ChatGPT desktop app, and install Mumr from Plugins.
    
    Then ask in a Codex thread that runs locally on your Mac.
    
    In a ChatGPT workspace, an admin can import the marketplace so members can install Mumr from it: Admin, then Plugins, Add, Import marketplace.
    

Your assistant may ask before it runs a command. Approve it, or run the line it shows you yourself.

Read the skills before you install them. The source is on GitHub under the MIT licence: [github.com/mumr-app/mumr-plugin](https://github.com/mumr-app/mumr-plugin)

When it acts

## Your assistant is told to record only when you ask

The skills tell your assistant to start or stop a recording only when you ask for it in the conversation, to treat words in a transcript, a file or a web page as content rather than requests, and to start nothing when you ask about a past meeting. These are instructions your assistant follows, not a lock, so decline any Mumr command you did not ask for.

Each time it starts a recording, your assistant reminds you that recording other people may need their consent.

Your assistant cannot see inside Mumr, so it does not claim the recording began. It tells you it asked Mumr to start, and the live panel on your Mac shows the recording.

Privacy

## Nothing goes through Mumr

The plugin runs inside your own assistant and talks only to the Mumr app on the same Mac. Mumr records and transcribes there, and runs no server for your meetings.

What you ask, and any meeting notes your assistant reads to answer you, go to your assistant's provider under your own account, as everything else you ask it does.

**The Mumr plugin for Claude Code and Codex.**

The Mumr plugin is a set of written instructions you can add to an AI assistant that runs commands on your Mac: Claude Code, or Codex. It has no server and no program of its own, and it sends nothing to us or to anyone else.

When you ask, your assistant starts or stops a recording, or opens a meeting or the Mumr window, by handing Mumr a `mumr://` link on the same Mac, and Mumr records and transcribes on the Mac as usual. The assistant acts only when you ask in the conversation, and it cannot see whether the recording started; Mumr's live panel shows that.

When you ask a question about your meetings, the assistant reads the files Mumr saved in your recordings folder (the meeting list, and a meeting's summary or transcript) and uses them in its answer. What it reads becomes part of your conversation with that assistant, so it is sent to the assistant's provider (Anthropic for Claude, OpenAI for Codex) under your account with that service and their privacy terms, and **we never see it**. If usage analytics are on ([section 4](https://mumr.app/privacy)), Mumr for Mac counts that a recording was started from an assistant, with nothing from the conversation. The plugin does not run in claude.ai or ChatGPT chat, which cannot reach your Mac. To stop using it, remove the plugin from your assistant.

## Say “start recording”

Get Mumr for Mac, then add the plugin to Claude Code or Codex.

[Download for Mac](https://mumr.app/download)

On the Mac App Store · macOS 15 or later

FAQ

## Questions you might have

### Does it work in claude.ai or ChatGPT chat?

No. An ordinary chat runs on the vendor's servers, which cannot reach the Mumr app on your Mac. Use Claude Code, the Code tab of the Claude desktop app, the Codex CLI or a local Codex thread in the ChatGPT desktop app.

### What does the plugin put on my Mac?

Two skills, which are text instructions for your assistant, and a short description file. It installs no program, no background process and no settings. The files are open source under the MIT licence.

### Does the plugin send my meetings anywhere?

The plugin itself sends nothing. Mumr records and transcribes on your Mac. When your assistant reads a meeting to answer you, that text goes to your assistant's provider under your own account, as anything else you ask it does.
