Skip to main content

MacOS

You can install Unblocked MCP in the Unblocked Mac app.
  1. Open the Unblocked Mac App
  2. Open up the top-right menu
  3. Select Install IDE Plugins
mac-app-install-ide-plugins
This will configure to use a local MCP server inside the Unblocked Mac app. The MCP server will use the login credentials from the Unblocked Mac app.

Linux and Windows

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.