Listen Install

Requires Parrot Scribe Pro. MCP server access is part of Parrot Scribe Pro. Existing licenses already include Pro.

Shared setup

Do this once in Parrot Scribe before you touch any host config.

1. Open Settings > MCP.
2. Enable the MCP server.
3. Create one token per client. Copy it when shown; it is only shown once.

A client appears under Clients the first time it connects with its token, and starts in Enabled mode with recording control, so /parrot:listen can start and stop sessions.

Every local host uses the bundled stdio shim:

/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim --token <token>

Restart the host after you save its config.

The plugin catalog 3jct-com/parrotscribe-plugins is private. /plugin marketplace add 3jct-com/parrotscribe-plugins fails without org access. Customers use the shim. Slash commands /parrot:listen and /parrot:recap are not a customer install path until that catalog is listed.

Org members who already have access can add the catalog on hosts that have slash commands. Other hosts get the shim and MCP tools, not /parrot:listen.

Claude Desktop

Connect MCP in ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "parrotscribe": {
      "command": "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim",
      "args": ["--token", "<token-from-settings>"]
    }
  }
}

Org members with catalog access can also run:

/plugin marketplace add 3jct-com/parrotscribe-plugins

Claude Code and Cowork

Connect MCP from the CLI:

claude mcp add --transport stdio parrotscribe -- "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim" --token <token-from-settings>

Or put this stdio block in ~/.claude.json or .mcp.json:

{
  "mcpServers": {
    "parrotscribe": {
      "command": "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim",
      "args": ["--token", "<token-from-settings>"]
    }
  }
}

ChatGPT desktop and Codex

ChatGPT desktop and Codex share ~/.codex/config.toml and support local STDIO. Add:

[mcp_servers.parrotscribe]
command = "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim"
args = ["--token", "<token-from-settings>"]

ChatGPT web is not a local stdio host. Codex and ChatGPT desktop get MCP tools, not /parrot:listen.

Grok Build

Connect it as a stdio MCP host:

{
  "mcpServers": {
    "parrotscribe": {
      "command": "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim",
      "args": ["--token", "<token-from-settings>"]
    }
  }
}

Stdio-only Grok Build gets MCP tools, not /parrot:listen.

Gemini CLI

Add this mcpServers entry in ~/.gemini/settings.json:

{
  "mcpServers": {
    "parrotscribe": {
      "command": "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim",
      "args": ["--token", "<token-from-settings>"]
    }
  }
}

Gemini CLI gets MCP tools, not /parrot:listen.

Antigravity

Use ~/.gemini/config/mcp_config.json or .agents/mcp_config.json:

{
  "mcpServers": {
    "parrotscribe": {
      "command": "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim",
      "args": ["--token", "<token-from-settings>"]
    }
  }
}

Antigravity gets MCP tools, not /parrot:listen.

Cursor

Add the shim in .cursor/mcp.json:

{
  "mcpServers": {
    "parrotscribe": {
      "command": "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim",
      "args": ["--token", "<token-from-settings>"]
    }
  }
}

Cursor gets MCP tools, not /parrot:listen.

OpenCode

OpenCode does not use mcpServers. Add the server by name under mcp in ~/.config/opencode/opencode.json or the project opencode.json:

{
  "mcp": {
    "parrotscribe": {
      "type": "local",
      "command": [
        "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim",
        "--token",
        "<token-from-settings>"
      ]
    }
  }
}

OpenCode gets MCP tools, not /parrot:listen.

Other stdio hosts

Any other local stdio MCP host uses the same shim command and token. Those hosts get MCP tools, not /parrot:listen.

Maintenance

• Rotate the token in Settings > MCP, then put the new value in the host config and restart the host.
• Org members can update the marketplace add after the listing changes.
• Restart the host after any config, token, or catalog change.
• Check the client's access level in Settings > MCP if a tool stops working. Disabled blocks every tool.

Tool tables and the access model stay on MCP Server. How /parrot:listen and /parrot:recap work is on Listen and Recap.