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 an API key.
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.A future version of MCP for Unblocked will allow specifying which data sources the MCP tools will be given access to.
1

Create the API Token

In the Unblocked web app, click on Settings —> API Tokens.Click on Create Token, fill out the token name, and click the Create Token button.MCP Token[]
2

Copy the API Token

Copy the resulting API token.MCP Token[]
3

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.
⌘I