# Connect Openwork MCP

Connect the OpenWork MCP Gateway (https://api.openworklabs.com/mcp/agent) to Claude...

- Repository: https://github.com/different-ai/openwork (24362 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add different-ai/openwork --skill connect-openwork-mcp -g -a claude-code -y`
Codex: `npx skills add different-ai/openwork --skill connect-openwork-mcp -g -a codex -y`
Cursor: `npx skills add different-ai/openwork --skill connect-openwork-mcp -g -a cursor -y`
Gemini CLI: `npx skills add different-ai/openwork --skill connect-openwork-mcp -g -a gemini-cli -y`

## Description

Connect the OpenWork MCP Gateway (https://api.openworklabs.com/mcp/agent) to Claude Code, Codex, Gemini CLI, Cursor, VS Code, Claude Desktop, or ChatGPT so the agent can use the user's OpenWork organization skills, plugins, and connections.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Connect the OpenWork MCP Gateway

Server URL: `https://api.openworklabs.com/mcp/agent`
Transport: Streamable HTTP. Auth: OAuth (PKCE, dynamic client registration); the client opens a browser for sign-in. No API key is needed.

The user needs an OpenWork Cloud account. If they don't have one, send them to https://app.openworklabs.com?mode=sign-up first.

## 1. Add the server

Use the command for the client you are running in. If an `openwork` entry already exists, don't add a duplicate; sign in with the existing one.

Claude Code:

```sh
claude mcp add --transport http openwork https://api.openworklabs.com/mcp/agent
# add `-s user` to make it available in every project
```

Codex:

```sh
codex mcp add openwork --url https://api.openworklabs.com/mcp/agent
codex mcp login openwork
```

Gemini CLI:

```sh
gemini mcp add --transport http openwork https://api.openworklabs.com/mcp/agent
```

OpenCode:

```sh
opencode mcp add openwork --url https://api.openworklabs.com/mcp/agent
opencode mcp auth openwork
```

Cursor, VS Code, Claude Desktop, ChatGPT, Windsurf, Zed: add `https://api.openworklabs.com/mcp/agent` as a remote MCP server. Per-client steps: https://openworklabs.com/docs/start-here/connect-openwork-mcp

## 2. Sign in

- Claude Code: run `/mcp`, select `openwork`, and authenticate.
- Codex: `codex mcp login openwork` opens the browser.
- Gemini CLI: run `/mcp auth openwork`.
- OpenCode: `opencode mcp auth openwork` opens the browser.

The user signs in and picks their organization. The organization is pinned to the token; to switch, log out of the `openwork` server and sign in again.

## 3. Verify

1. `claude mcp list` (or the client's equivalent) shows `openwork`.
2. Restart the agent session so the new tools load.
3. The agent has the `search_capabilities` and `execute_capability` tools.
4. Ask: "Which OpenWork organization am I connected to?"

Don't claim the connection works until step 3 passes.

## If it fails

The rest: https://github.com/different-ai/openwork/blob/HEAD/ee/apps/landing/public/.well-known/agent-skills/connect-openwork-mcp/SKILL.md