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
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.
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:
- 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 a 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.![Personal Token[]](https://mintlify.s3.us-west-1.amazonaws.com/unblocked/img/personal-token-1.png)
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[]](https://mintlify.s3.us-west-1.amazonaws.com/unblocked/img/personal-token-2.png)
Copy the API Token
Copy the resulting API token.![Personal Token[]](https://mintlify.s3.us-west-1.amazonaws.com/unblocked/img/personal-token-3.png)
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.![Team Token[]](https://mintlify.s3.us-west-1.amazonaws.com/unblocked/img/team-token-1.png)
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.![Team Token[]](https://mintlify.s3.us-west-1.amazonaws.com/unblocked/img/team-token-2.png)
Copy the API Token
Copy the resulting API token.![Team Token[]](https://mintlify.s3.us-west-1.amazonaws.com/unblocked/img/team-token-3.png)
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.