Set up Notta MCP and CLI

Use Notta MCP to work with your recordings through an AI assistant, or Notta CLI to work from your command line. Follow the section for the tool you want to use. You don't need to install both.

Before you start

Before setting up Notta MCP or Notta CLI, make sure you have:

• A Notta account
• Node.js and npm
• Permission to install software on your computer

For MCP, you also need an AI assistant that supports local MCP servers. This guide includes examples for Claude Desktop, Cursor, and Codex.

Set up Notta MCP

1. Install Notta MCP

Open your terminal or command-line app and run:

npm install -g @notta-labs/notta-mcp

Wait for installation to finish without errors. You don't need to install Notta CLI to use MCP.

2. Add Notta to your AI assistant

Create dedicated folders for uploads and downloads. Replace the example paths below with the full paths to those folders. Both folders must already exist.

Follow the instructions for your assistant only. Back up its configuration file before editing, and keep your existing settings. In file locations, ~ means your home folder.

Claude Desktop or Cursor

Open the relevant file in a plain-text editor.

For a new or empty file, use:

{
  "mcpServers": {
    "notta": {
      "command": "notta-mcp",
      "args": [
        "/Users/you/Notta Media",
        "/Users/you/Notta Exports"
      ]
    }
  }
}

If mcpServers already exists, add only the notta entry inside it. If a notta entry already exists, update it instead of adding a duplicate.

For more help, see the Claude Desktop configuration guide or Cursor MCP guide.

Codex

Open ~/.codex/config.toml in a plain-text editor and add:

[mcp_servers.notta]
command = "notta-mcp"
args = [
  "/Users/you/Notta Media",
  "/Users/you/Notta Exports",
]

If [mcp_servers.notta] already exists, update it instead of adding a duplicate. See the Codex MCP guide for more help.

Save your changes, then fully quit and reopen your assistant. Files you upload and download destinations must stay inside the folders you configured.

3. Connect your Notta account

Send this request in your AI assistant:

Use Notta MCP's auth_setup tool to connect my Notta account.

Review any approval request, then sign in and authorize the connection in your browser. After authorization, ask:

Use Notta MCP's auth_status and auth_user_info tools to confirm I'm signed in to the correct account.

These are requests for your assistant, not terminal commands.

4. Try your first request

Ask your assistant:

Use Notta MCP to list five of my recordings.

If the request succeeds, you're connected. Choose a recording and ask your assistant to show its transcript.

Set up Notta CLI

1. Install Notta CLI

Open your terminal or command-line app and run these commands one at a time:

npm install -g @notta-labs/notta-cli
notta --version

You should see a version number. You don't need an AI assistant or Notta MCP to use the CLI.

2. Connect your Notta account

Start sign-in:

notta auth setup

Sign in and authorize the connection in your browser. Return to your terminal, then check your connection and account:

notta auth status
notta auth user info

Continue once authorization is confirmed and the account is correct.

3. Try your first command

List up to five recordings:

notta record list --page-size 5

If the request succeeds, you're connected. To read a transcript, copy a record ID from the results and replace RECORD_ID below:

notta record view RECORD_ID

The recording's transcription must be complete before you can read it.

If setup doesn't work

• Command not found: Check that installation finished successfully, then reopen your terminal or AI assistant.
• MCP tools missing: Check your configuration and folder paths, then restart your assistant.
• Sign-in fails: Save the exact error and see Troubleshoot Notta MCP and CLI.
• No recordings listed: An empty list without an error may mean no recordings are available to the connected account.

Still need help?

FAQs