Install: Claude Code

Quick install (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 supported tools and agents automatically.

The install script is currently supported on macOS only. Windows and Linux users should use the manual install instructions below.

Marketplace

Add the Unblocked marketplace

Run the following command in Claude Code:

/plugin marketplace add unblocked/skills

Install the Unblocked plugin

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

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.

Manual install (macOS, Windows, Linux)

You can connect Claude Code to remote Unblocked MCP with the following command line:

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:

Launch Claude Code
Run /mcp
Select unblocked — this should be shown with a label disconnected
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 Personal or Team API Tokens.

Personal Access Token
Team Access Token

Create the API Token

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

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.

Copy the API Token

Copy the resulting API token.

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.

This connection method uses an API token that gives access to every document in your Unblocked team’s data sources. If your team has connected sensitive data, such as private Slack channels, the MCP tools will potentially return this data in its queries.

Create the API Token

In the Unblocked web app, click on Settings —> API Tokens.In the Team API Tokens section, click on Create Token.

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.

Copy the API Token

Copy the resulting API token.

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.

Getting Started with Unblocked

Product Guides

Using Unblocked

Personal Settings

Team Settings

Billing

Data Sources

Install: Claude Code

Quick install (macOS)

Marketplace

Manual install (macOS, Windows, Linux)

Headless Automation

​Quick install (macOS)

​Marketplace

​Manual install (macOS, Windows, Linux)

​Headless Automation

Quick install (macOS)

Marketplace

Manual install (macOS, Windows, Linux)

Headless Automation