# WorkOS (MCP server)

> WorkOS is an MCP server that adds tools to AI assistants such as Claude Code, Cursor and VS Code. Manage your WorkOS workspace in plain language: orgs, users, SSO, Directory Sync, and AuthKit. It has 45 GitHub stars, is released under the MIT license and runs as a remote server at https://mcp.workos.com/mcp.

Manage your WorkOS workspace with AI agents. The WorkOS MCP server is a remote Model Context Protocol server. Any MCP client can use it to manage organizations, users, SSO connections, directories, branding, and more, by calling the WorkOS API on your behalf.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/workos/skills |
| GitHub stars | 45 |
| License | MIT |
| Language | JavaScript |
| Transport | streamable-http |
| Packages | none (remote only) |
| Remote URL | https://mcp.workos.com/mcp |
| Needs API key | no |
| Official | yes |
| Works with | Claude Code, Cursor, VS Code, Claude.ai, ChatGPT |
| Category | Other |
| Latest release | v0.7.3 (Sep 18, 2026) |
| Last commit | Sep 30, 2026 |
| MCP registry name | com.workos/mcp |

## Install

### Claude Desktop

```
Settings > Connectors > Add custom connector
URL: https://mcp.workos.com/mcp
```

Remote servers are added as a custom connector, not in claude_desktop_config.json.

### Claude Code

```sh
claude mcp add --transport http workos "https://mcp.workos.com/mcp"
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "workos": {
      "url": "https://mcp.workos.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "workos": {
      "type": "http",
      "url": "https://mcp.workos.com/mcp"
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Tools

- `whoami`: Returns your identity, role, and the environments you can reach.
- `list_operations`: Lists the WorkOS operations available to the agent, with parameters.
- `query`: Runs a read-only operation from the catalog, such as listing organizations or users.
- `mutate`: Runs a write operation from the catalog, such as creating an organization or inviting a user.
- `setup_account`: Provisions a WorkOS workspace for a first-time user.

## Similar MCP servers

- [Reactive Resume](https://appsgit.com/mcp-servers/reactive-resume): A one-of-a-kind resume builder that keeps your privacy in mind. (43,921 stars, MIT)
- [N8n MCP](https://appsgit.com/mcp-servers/n8n-mcp): A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you. (23,047 stars, MIT)
- [XHS Downloader](https://appsgit.com/mcp-servers/xhs-downloader): 小红书（XiaoHongShu、RedNote）链接提取/作品采集工具. (12,922 stars, GPL-3.0)
- [MCP Use](https://appsgit.com/mcp-servers/mcp-use): The fullstack MCP framework to develop MCP Apps for ChatGPT / Claude & MCP Servers for AI Agents. (10,726 stars, MIT)
- [Ha MCP](https://appsgit.com/mcp-servers/ha-mcp): Comprehensive Model Context Protocol server for managing Home Assistant through AI assistants. (4,964 stars, MIT)
- [MCP Server Chart](https://appsgit.com/mcp-servers/mcp-server-chart): A Model Context Protocol server for generating charts using AntV. (4,391 stars, MIT, needs API key)

---

Canonical page: https://appsgit.com/mcp-servers/workos
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.