Integrations / Connect Your Agent
IntegrationsUpdated October 24, 2026
Connect Your Agent
Connect Claude, Codex and Cursor from Settings, then AI Apps
Version: This guide describes Parrot Scribe 1.1.0.
Requires Parrot Scribe Pro. MCP server access is part of Parrot Scribe Pro. Existing licenses already include Pro.
Connect Claude, Codex or Cursor from Parrot Scribe. After upgrading from 1.0.x, connect each app again: earlier approvals and tokens do not authorize 1.1.0.
| Your desktop app | Start here |
|---|---|
| Claude Desktop | Claude Desktop |
| Codex | Codex |
| Cursor | Cursor |
The Parrot Scribe catalog is for Claude Code and the Codex CLI. It does not install the three desktop rows. Parrot Scribe creates those connections on this Mac.
Shared setup
- Install Parrot Scribe at
/Applications/Parrot Scribe.app. - Open the desktop AI app you want to connect and leave it running.
- In Parrot Scribe, open Settings > AI Apps. This requires Pro.
- Choose Connect on the row for that app. A row that is already set up shows Manage… first; open it, then choose Connect.
- Finish installation in the AI app. Its own permission prompts still apply.
Connect approves that desktop app on this Mac. It stays connected while you use it, including after you quit and reopen the AI app. Choose Connect again only after Disconnect, or after 90 days without use.
Each row keeps its own status:
| Status | Meaning |
|---|---|
| Connected | That app has an authenticated connection now. |
| Set up · Idle | That app is connected and ready, with no request in progress. Its next request resumes the connection. |
| Set up · Not connected | The app is configured but not connected right now, for example because it is closed. When it starts again, it reconnects with the same approval. |
| Approval expired | The app was not used for 90 days. Choose Manage… > Connect. |
| Not set up | Choose Connect. |
| A setup error | Read the message on that row and try Connect again. Disconnecting one app does not remove the others. |
Parrot Scribe keeps each app's credential in this Mac's Keychain and starts its signed helper with the app's name. Do not copy a token into a desktop app, a shell profile or a chat message. A cloud or mobile session cannot reach this Mac by installing a plugin.
Access
Each row starts with Simple access: the app can read the library, control recording and name speakers in a session. Simple cannot delete sessions or remove speakers. Trusted also allows those destructive tools without another prompt; granting it asks you to confirm. Choose Use Simple Access to remove it. See MCP Server.
Claude Desktop
Choose Connect on the Claude row. Parrot Scribe opens a local Claude extension, ParrotScribe.mcpb, that provides the connection. Claude can show an unreviewed-extension warning. That warning belongs to Claude.
If you choose Disconnect and then Connect again, Claude can still have the earlier extension installed. If Claude offers Uninstall instead of installing, choose Uninstall, then Install.
Parrot Scribe's MCP server sends its usage and listening guidance with the connection. If Claude does not apply MCP server instructions, load the listening contract in a project or chat. Cowork is a separate host; these steps do not configure it.
Codex
Choose Connect on the Codex row. Parrot Scribe opens Codex with a local plugin that provides the connection. Complete the installation in Codex, then start a new local task.
A web, mobile or cloud task does not gain access to this Mac. Use a local task.
Cursor
Choose Connect on the Cursor row. Parrot Scribe opens Cursor's MCP install handoff for the connection. Complete it in Cursor, then start a new chat.
After Parrot Scribe restarts, Cursor does not reconnect by itself. Open Cursor's MCP settings and choose Reload for Parrot Scribe.
Check the connection
- Confirm the row says Connected or Set up · Idle after the app makes a request.
- Ask the app to call
get_statuswithout starting a recording. - Ask it to call
list_sessionswithlimit: 2. An emptysessionsarray is valid for an empty library. - Select a session you intend to share before asking for a recap. See Listen and Recap.
If setup says it could not verify the AI app, open it, or quit and reopen it if it is already open, then choose Connect again. If a row stays at Set up · Not connected while the app is open, quit and reopen that app. If tools are missing, finish the handoff in that app and start a new task or chat.
Other local hosts
Claude Code, the Codex CLI, and other local stdio hosts are not rows in AI Apps. Use one token per host from Settings > AI Apps > Advanced. Copy the token when it is shown. It is shown once.
The shim reads PARROTSCRIBE_MCP_TOKEN from its environment. Parrot Scribe rejects --token and --token=.... Keep tokens out of command arguments, project files, shell profiles, and chat messages.
The signed shim is:
/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim
If a host already has a Parrot Scribe connection, keep one enabled connection. Do not leave two tool sets active.
Claude Code
Install the catalog and plugin:
/plugin marketplace add 3jct-com/parrotscribe-plugins
/plugin install parrot@parrotscribe-plugins
Plugin 0.4.0 includes the connection for Claude Code. Enter this client's token in the plugin's Parrot Scribe client token prompt. Create that token in Advanced. Claude Code stores it in its credential store and supplies it to the shim. Use a current Claude Code version with userConfig support.
Do not add a second manual connection after installing the plugin. Start a new session and use /parrot:listen or /parrot:recap.
After upgrading from 1.0.x, the plugin still holds the earlier token, which 1.1.0 refuses. Create a new token in Advanced and enter it in the plugin's configuration through /plugin.
Codex CLI
Add the catalog, install the plugin, and start a new session:
codex plugin marketplace add 3jct-com/parrotscribe-plugins
Supply a separate token in the Codex host's environment. The plugin forwards PARROTSCRIBE_MCP_TOKEN. This is not the Codex row above. A manual connection uses:
[mcp_servers.parrotscribe]
command = "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim"
env_vars = ["PARROTSCRIBE_MCP_TOKEN"]
Keep one enabled connection. Do not reuse this token for another host.
Hosts that need an environment mapping
Use the same shim and a separate token. If the host does not pass PARROTSCRIBE_MCP_TOKEN to the shim, use the Keychain launcher below.
Grok Build, in ~/.grok/config.toml:
[mcp_servers.parrotscribe]
command = "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim"
env = { PARROTSCRIBE_MCP_TOKEN = "${PARROTSCRIBE_MCP_TOKEN}" }
Gemini CLI, in ~/.gemini/settings.json:
{
"mcpServers": {
"parrotscribe": {
"command": "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim",
"env": {
"PARROTSCRIBE_MCP_TOKEN": "$PARROTSCRIBE_MCP_TOKEN"
}
}
}
}
OpenCode, under mcp in ~/.config/opencode/opencode.json:
{
"mcp": {
"parrotscribe": {
"type": "local",
"command": [
"/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim"
],
"environment": {
"PARROTSCRIBE_MCP_TOKEN": "{env:PARROTSCRIBE_MCP_TOKEN}"
}
}
}
}
These hosts get the MCP tools. Hosts that apply MCP server instructions also get the server's usage guidance. The /parrot:listen and /parrot:recap commands come only with the Claude Code plugin.
Keychain launcher for other hosts
Use this when a host cannot inject the token into the shim's environment. Create a generic password item in Keychain Access for that host. Save the token as the password. Do not reuse another host's token.
Save this script at an absolute path such as /Users/you/.local/bin/parrotscribe-mcp-keychain. Replace /Users/you with your account path. The script contains no token:
#!/bin/zsh
set -eu
: "${PARROTSCRIBE_MCP_KEYCHAIN_ITEM:?Set PARROTSCRIBE_MCP_KEYCHAIN_ITEM}"
PARROTSCRIBE_MCP_TOKEN=$(/usr/bin/security find-generic-password -w -s "$PARROTSCRIBE_MCP_KEYCHAIN_ITEM")
export PARROTSCRIBE_MCP_TOKEN
exec "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim" "$@"
Run chmod 700 /Users/you/.local/bin/parrotscribe-mcp-keychain. Point the host's command at that script and pass only the Keychain item name:
{
"command": "/Users/you/.local/bin/parrotscribe-mcp-keychain",
"env": {
"PARROTSCRIBE_MCP_KEYCHAIN_ITEM": "Parrot Scribe MCP Host Name"
}
}
Do not use this launcher for the Claude, Codex or Cursor rows. Those rows manage the credential.
Maintenance
- To disconnect Claude, Codex or Cursor, choose Disconnect on that row. Other apps stay configured.
- To rotate a token for another host, choose Revoke Token… in Advanced, create a replacement, update the secret source, and restart the host.
- For an old
--tokensetup, remove the token from the command or config. Use Advanced or the Keychain launcher, then restart the host. Revoke a token that was exposed in a command, log or copied file. - Restart the host after a token or configuration change.
The signed helper is also available as parrotscribe-mcp in the same folder. Existing configurations that use parrotscribe-mcp-shim keep working with a new token.
Tool arguments and access controls are documented in MCP Server. The workflow is explained in Listen and Recap.