Locus plugin and skills

The Locus plugin gives your coding or desktop agent the Locus connection plus three skills that teach it how to use Locus well. Use it instead of a manual MCP setup when your client supports plugins. For clients without plugins, one prompt runs the Locus installer.

How it works

The plugin is a bundle. It adds the OAuth connection to the Locus MCP server and installs the skills. Your client signs you in through the browser and stores and refreshes the tokens.

Skill	What it teaches your agent
Locus (`locus`)	Choose Tools and Recipes, check prices, and use results
Locus setup (`locus-setup`)	Install, sign in, and set up the account
Locus Workflows (`locus-workflows`)	Build, test, save, and run repeatable processes

Install the plugin

The plugin lives in the locus-pro-plugin repository.

Claude Code CLI
Claude Code app
Codex CLI / app
Grok
Other plugin clients

/plugin marketplace add locus-technologies/locus-pro-plugin
/plugin install locus@locus

Run /mcp, select locus, and choose Authenticate.

In Code, open Customize → Plugins → Add plugin → Add marketplace → Add from a repository. Choose locus-technologies/locus-pro-plugin, select Sync, then Add Locus.Authenticate the plugin from Terminal:

claude mcp login plugin:locus:locus

Complete browser consent, then start a new Code session.If the login command says plugin:locus:locus is missing and claude mcp get locus reports a legacy Local config, remove the project entry, restart Code, and retry:

claude mcp remove locus -s local

codex plugin marketplace add locus-technologies/locus-pro-plugin
codex plugin add locus@locus
codex mcp login locus --scopes mcp:read,mcp:execute,offline_access

Start a new CLI or desktop session after installation.

Review the plugin repository, then install:

grok plugin install locus-technologies/locus-pro-plugin --trust

Grok opens browser sign-in when you first use the connection.

Other Agent Plugins clients can install the same bundle:

npx plugins add locus-technologies/locus-pro-plugin

Keep one OAuth entry per client. If you added the server manually first, remove that entry.
Update through your client’s plugin manager, then start a fresh session. See the release notes; marketplace listings may update later than GitHub.
To connect with an agent key instead of OAuth, use the manual configuration.

Set up with one prompt

For OpenClaw, Hermes, Muse, and Instinct, send this prompt in a new agent session:

Install Locus Pro by following https://paywithlocus.com/SKILL.md.

The installer picks an MCP or CLI adapter, installs the three skills, starts sign-in, and checks a free readiness operation. Complete any browser approval or restart it asks for. You can also copy this prompt from Connect → Set up. Copy prompt asks how the agent will sign in:

In your browser: the agent sends you a link to approve.
With an agent key: Locus creates a 30-day agent key and puts it in the prompt. Use this for agents that run on their own. The agent saves the key and signs in to the Locus CLI with it.

A prompt that holds an agent key is a secret. Send it only to the agent that will use it.

Hermes does not currently have a public plugin listing, and current OpenClaw does not import the MCP entry from its marketplace bundle. Use the one-prompt setup for both.

Install only the skills

If you connected your client manually, add the skills on their own:

Install the skills

npx skills add locus-technologies/locus-pro-plugin

Select locus, locus-setup, and locus-workflows when prompted. Skills still need an authenticated MCP connection. Clients without local skill support can load the same guides through MCP with get_locus_guide.

Getting started

Build with Locus Pro

Connect agents

Pricing & plans

Funding & billing

Developer tools

Catalog directory

Testing

Locus plugin and skills

How it works

Install the plugin

Set up with one prompt

Install only the skills

Next steps

Connect an MCP client

MCP

​How it works

​Install the plugin

​Set up with one prompt

​Install only the skills

​Next steps

Connect an MCP client

MCP

How it works

Install the plugin

Set up with one prompt

Install only the skills

Next steps