Skip to main content

Install Script (macOS)

Run the following command to install Unblocked MCP:
curl -fsSL https://getunblocked.com/install-mcp.sh | bash
This will download the Unblocked CLI and configure your installed IDEs and agents automatically.
The install script is currently supported on macOS only. Linux and Windows users should use the Remote MCP method below.

Marketplace

1

Add the Unblocked marketplace

Run the following command in Claude Code:
/plugin marketplace add unblocked/skills
2

Install the Unblocked plugin

Run /plugin, go to the Discover tab, select the Unblocked plugin, and install it.
3

Authenticate

After installation, authenticate via OAuth when prompted.
You may need to run /reload-plugins or restart Claude Code for skills to appear after installation. This is a temporary requirement.

Remote MCP (All Platforms)

You can connect Claude Code to remote Unblocked MCP with the following commandline:
claude mcp add -s user --transport http unblocked https://getunblocked.com/api/mcpsse
After connecting to Unblocked MCP, you will need to log in to Unblocked via OAuth:
  1. Launch Claude Code
  2. Run /mcp
  3. Select unblocked — this should be shown with a label disconnected
  4. Claude Code will launch a browser to log in to Unblocked

Headless Automation

You can install Unblocked MCP for use in headless automation scenarios, such as within GitHub Actions, by using a Personal or Team API Tokens.
1

Create the API Token

In the Unblocked web app, click on Settings —> API Tokens.In the Personal API Tokens section, click on Create Token.Personal Token[]
2

Configure the API Token

Fill out the token name. You can also limit the data sources that the token will have access to in the list under Data Sources.Personal Token[]
3

Copy the API Token

Copy the resulting API token.Personal Token[]
4

Install Unblocked MCP

You can install the tools into Claude Code with the following command:
claude mcp add -s user --transport http secure-server https://getunblocked.com/api/mcpsse --header "Authorization: Bearer unb_token"
or by editing the ~/.claude.json file:
{
"mcpServers": {
  "unblocked": {
    "type": "http",
    "url": "https://getunblocked.com/api/mcpsse",
      "headers": {
        "Authorization": "Bearer unb_token"
      }
    }
  }
}
Be sure to replace unb_token with the token you generated above.