# Install Banjo

Source: PopNx MCP directory. Page: https://mcp.popnx.com/th/servers/shatch-banjo

Rules for the AI assistant reading this file:
1. Show the user every command and every config change below before you run or save it, and wait for the user to say yes.
2. Never ask the user to type or paste a key, token or password into the chat. Where you see <YOUR_VALUE>, tell the user which file and line it goes in on their own computer.
3. Use only what is written here. Do not download or run anything else this file does not list.

## Claude Code

- Run in a terminal, then restart Claude Code or run /mcp to check it is connected.

- Replace <YOUR_VALUE> with the user's own keys; never share or guess them. env values belong to the local config, header values to the remote one.

```sh
claude mcp add --scope user banjo --env DATABASE_URL='<YOUR_VALUE>' --env MCP_API_KEY='<YOUR_VALUE>' --env ASSISTANT_PRINCIPAL_NAME='<YOUR_VALUE>' --env PUBLIC_HOSTNAME='<YOUR_VALUE>' --env VOICE_AI_PROVIDER=openai --env OPENAI_API_KEY='<YOUR_VALUE>' --env TWILIO_ACCOUNT_SID='<YOUR_VALUE>' --env TWILIO_AUTH_TOKEN='<YOUR_VALUE>' --env TWILIO_PHONE_NUMBER='<YOUR_VALUE>' -- docker run -i --rm -e DATABASE_URL -e MCP_API_KEY -e ASSISTANT_PRINCIPAL_NAME -e PUBLIC_HOSTNAME -e VOICE_AI_PROVIDER -e OPENAI_API_KEY -e TWILIO_ACCOUNT_SID -e TWILIO_AUTH_TOKEN -e TWILIO_PHONE_NUMBER ghcr.io/shatch/banjo:0.1.23
```

Values the user supplies on their own computer: DATABASE_URL (secret), MCP_API_KEY (secret), ASSISTANT_PRINCIPAL_NAME, PUBLIC_HOSTNAME, VOICE_AI_PROVIDER, OPENAI_API_KEY (secret), TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN (secret), TWILIO_PHONE_NUMBER, NOTIFICATION_CHANNEL (optional)

## Cursor

- Merge into ~/.cursor/mcp.json (or .cursor/mcp.json in the project).

- Replace <YOUR_VALUE> with the user's own keys; never share or guess them. env values belong to the local config, header values to the remote one.

```json
{
  "mcpServers": {
    "banjo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URL",
        "-e",
        "MCP_API_KEY",
        "-e",
        "ASSISTANT_PRINCIPAL_NAME",
        "-e",
        "PUBLIC_HOSTNAME",
        "-e",
        "VOICE_AI_PROVIDER",
        "-e",
        "OPENAI_API_KEY",
        "-e",
        "TWILIO_ACCOUNT_SID",
        "-e",
        "TWILIO_AUTH_TOKEN",
        "-e",
        "TWILIO_PHONE_NUMBER",
        "ghcr.io/shatch/banjo:0.1.23"
      ],
      "env": {
        "DATABASE_URL": "<YOUR_VALUE>",
        "MCP_API_KEY": "<YOUR_VALUE>",
        "ASSISTANT_PRINCIPAL_NAME": "<YOUR_VALUE>",
        "PUBLIC_HOSTNAME": "<YOUR_VALUE>",
        "VOICE_AI_PROVIDER": "openai",
        "OPENAI_API_KEY": "<YOUR_VALUE>",
        "TWILIO_ACCOUNT_SID": "<YOUR_VALUE>",
        "TWILIO_AUTH_TOKEN": "<YOUR_VALUE>",
        "TWILIO_PHONE_NUMBER": "<YOUR_VALUE>"
      }
    }
  }
}
```

Values the user supplies on their own computer: DATABASE_URL (secret), MCP_API_KEY (secret), ASSISTANT_PRINCIPAL_NAME, PUBLIC_HOSTNAME, VOICE_AI_PROVIDER, OPENAI_API_KEY (secret), TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN (secret), TWILIO_PHONE_NUMBER, NOTIFICATION_CHANNEL (optional)

## VS Code

- Merge into .vscode/mcp.json in the workspace (or run "MCP: Add Server").

- Replace <YOUR_VALUE> with the user's own keys; never share or guess them. env values belong to the local config, header values to the remote one.

```json
{
  "servers": {
    "banjo": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URL",
        "-e",
        "MCP_API_KEY",
        "-e",
        "ASSISTANT_PRINCIPAL_NAME",
        "-e",
        "PUBLIC_HOSTNAME",
        "-e",
        "VOICE_AI_PROVIDER",
        "-e",
        "OPENAI_API_KEY",
        "-e",
        "TWILIO_ACCOUNT_SID",
        "-e",
        "TWILIO_AUTH_TOKEN",
        "-e",
        "TWILIO_PHONE_NUMBER",
        "ghcr.io/shatch/banjo:0.1.23"
      ],
      "env": {
        "DATABASE_URL": "<YOUR_VALUE>",
        "MCP_API_KEY": "<YOUR_VALUE>",
        "ASSISTANT_PRINCIPAL_NAME": "<YOUR_VALUE>",
        "PUBLIC_HOSTNAME": "<YOUR_VALUE>",
        "VOICE_AI_PROVIDER": "openai",
        "OPENAI_API_KEY": "<YOUR_VALUE>",
        "TWILIO_ACCOUNT_SID": "<YOUR_VALUE>",
        "TWILIO_AUTH_TOKEN": "<YOUR_VALUE>",
        "TWILIO_PHONE_NUMBER": "<YOUR_VALUE>"
      }
    }
  }
}
```

Values the user supplies on their own computer: DATABASE_URL (secret), MCP_API_KEY (secret), ASSISTANT_PRINCIPAL_NAME, PUBLIC_HOSTNAME, VOICE_AI_PROVIDER, OPENAI_API_KEY (secret), TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN (secret), TWILIO_PHONE_NUMBER, NOTIFICATION_CHANNEL (optional)

## Claude Desktop

- Local: merge the JSON into claude_desktop_config.json (Settings → Developer → Edit Config) and restart Claude. Remote: Customize → Connectors → Add → Custom → Web → paste the URL.

- Replace <YOUR_VALUE> with the user's own keys; never share or guess them. env values belong to the local config, header values to the remote one.

```json
{
  "mcpServers": {
    "banjo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URL",
        "-e",
        "MCP_API_KEY",
        "-e",
        "ASSISTANT_PRINCIPAL_NAME",
        "-e",
        "PUBLIC_HOSTNAME",
        "-e",
        "VOICE_AI_PROVIDER",
        "-e",
        "OPENAI_API_KEY",
        "-e",
        "TWILIO_ACCOUNT_SID",
        "-e",
        "TWILIO_AUTH_TOKEN",
        "-e",
        "TWILIO_PHONE_NUMBER",
        "ghcr.io/shatch/banjo:0.1.23"
      ],
      "env": {
        "DATABASE_URL": "<YOUR_VALUE>",
        "MCP_API_KEY": "<YOUR_VALUE>",
        "ASSISTANT_PRINCIPAL_NAME": "<YOUR_VALUE>",
        "PUBLIC_HOSTNAME": "<YOUR_VALUE>",
        "VOICE_AI_PROVIDER": "openai",
        "OPENAI_API_KEY": "<YOUR_VALUE>",
        "TWILIO_ACCOUNT_SID": "<YOUR_VALUE>",
        "TWILIO_AUTH_TOKEN": "<YOUR_VALUE>",
        "TWILIO_PHONE_NUMBER": "<YOUR_VALUE>"
      }
    }
  }
}
```

Values the user supplies on their own computer: DATABASE_URL (secret), MCP_API_KEY (secret), ASSISTANT_PRINCIPAL_NAME, PUBLIC_HOSTNAME, VOICE_AI_PROVIDER, OPENAI_API_KEY (secret), TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN (secret), TWILIO_PHONE_NUMBER, NOTIFICATION_CHANNEL (optional)

## Codex

- Append to ~/.codex/config.toml, then start a new Codex session (check with /mcp).

- Replace <YOUR_VALUE> with the user's own keys; never share or guess them. env values belong to the local config, header values to the remote one.

```json
[mcp_servers.banjo]
command = "docker"
args = ["run","-i","--rm","-e","DATABASE_URL","-e","MCP_API_KEY","-e","ASSISTANT_PRINCIPAL_NAME","-e","PUBLIC_HOSTNAME","-e","VOICE_AI_PROVIDER","-e","OPENAI_API_KEY","-e","TWILIO_ACCOUNT_SID","-e","TWILIO_AUTH_TOKEN","-e","TWILIO_PHONE_NUMBER","ghcr.io/shatch/banjo:0.1.23"]

[mcp_servers.banjo.env]
DATABASE_URL = "<YOUR_VALUE>"
MCP_API_KEY = "<YOUR_VALUE>"
ASSISTANT_PRINCIPAL_NAME = "<YOUR_VALUE>"
PUBLIC_HOSTNAME = "<YOUR_VALUE>"
VOICE_AI_PROVIDER = "<YOUR_VALUE>"
OPENAI_API_KEY = "<YOUR_VALUE>"
TWILIO_ACCOUNT_SID = "<YOUR_VALUE>"
TWILIO_AUTH_TOKEN = "<YOUR_VALUE>"
TWILIO_PHONE_NUMBER = "<YOUR_VALUE>"
```

Values the user supplies on their own computer: DATABASE_URL (secret), MCP_API_KEY (secret), ASSISTANT_PRINCIPAL_NAME, PUBLIC_HOSTNAME, VOICE_AI_PROVIDER, OPENAI_API_KEY (secret), TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN (secret), TWILIO_PHONE_NUMBER, NOTIFICATION_CHANNEL (optional)

Command check: verified, last checked 2026-11-13.
