Skip to main content

​
Install

There are two install scripts, depending on how much you want set up for you. 
curl -fsSL https://getunblocked.com/install-mcp.sh | bash
Downloads the unblocked binary, runs unblocked install to configure every supported IDE and AI coding agent it detects, and installs skills. After the script finishes you are prompted to authenticate through the browser.Pick this script if you want a one-shot setup that wires Unblocked MCP into your existing tools.
If unblocked is not on your PATH, the install scripts place it in ~/.local/bin/ — add that directory to your PATH or invoke the binary directly. Verify the install: 
unblocked --version

​
Configure IDEs and agents

Once the CLI is installed, three commands control what gets wired into your IDEs and AI coding agents.

​
unblocked install

unblocked install
Configures every supported IDE it detects (Claude Code, Claude Desktop, Codex, Cursor, Windsurf, and others) with:
  • the Unblocked MCP server, and
  • the Unblocked skills that teach agents how to use it.
The install-mcp.sh quick install script runs this for you.

​
unblocked install-mcp

unblocked install-mcp
Configures supported IDEs with only the MCP server — skills are not installed. Use this when you manage skills separately (for example, via the Claude Code plugin marketplace or a shared skills repository).

​
unblocked install-skills

unblocked install-skills
Installs or refreshes the Unblocked skills in each detected agent without touching MCP configuration. Skills are stored in a canonical location at ~/.agents/skills/ and symlinked into each agent’s own skills directory (for example ~/.claude/skills/, ~/.cursor/skills/, ~/.codeium/windsurf/skills/). Running the CLI again automatically pulls the latest skills; if you have modified a skill locally the CLI stops updating that specific skill so your changes are preserved.
Per-IDE installation instructions — including plugin, manual, and headless/token-based setups — live under Unblocked MCP.

​
Update

unblocked update
Checks for a newer version of the Unblocked CLI and, if one is available, downloads and installs it in place. Run this when:
  • You see a notice that a new CLI version is available.
  • An MCP call or context-* command fails with a message indicating your CLI is out of date.
  • You want to pick up the latest skills and tool descriptions. Each CLI run refreshes skills automatically, but upgrading the CLI itself occasionally ships larger improvements.
If unblocked update cannot reach the update server — for example from an offline or firewalled environment — reinstall using either of the install scripts above.

​
Uninstall

unblocked uninstall
Completely removes Unblocked from the local machine:
  • Deletes the unblocked binary and supporting files.
  • Removes the MCP server entry from every IDE and agent the CLI previously configured.
  • Removes the Unblocked skills installed under ~/.agents/skills/ and the symlinks pointing into each agent’s skills directory.
  • Clears the cached authentication token created by unblocked auth.
unblocked uninstall does not sign you out of Unblocked anywhere except this machine. Existing sessions in the Unblocked web app, your messaging platforms, and API tokens generated in Unblocked settings remain active.
To remove MCP configuration from a single agent only, edit that agent’s MCP config file directly rather than running uninstall. The per-agent install guides under Unblocked MCP describe where those files live.