WorkOS APIを通じて、WorkOSの組織、ユーザー、SSO接続、ディレクトリ、およびAuthKitのブランディングを管理します。
別名 workos/skills, mcp
- スター
- 46
- ツール
- 5
- ダウンロード数(30日間)
- —
- 最新バージョン
- 1.0.0
- 最終コミット
- 2026年11月2日
- ライセンス
- MIT
WorkOS MCPとは
WorkOS APIを通じて、WorkOSの組織、ユーザー、SSO接続、ディレクトリ、およびAuthKitのブランディングを管理します。 5個のツールを提供しており、whoami, list_operations, queryなどがあります。
プロジェクトのREADMEから生成された概要
WorkOS MCP server について
このリモートMCP serverを使用すると、AIエージェントを通じてWorkOSの組織、ユーザー、およびSSO接続を管理できます。開発者は、好みのAIクライアントからWorkOS APIを直接呼び出すことで、ワークスペースの設定、ディレクトリ同期、AuthKitのブランディング、およびwebhookを制御できます。このserverはホストされたサービスとして動作し、Dynamic Client Registrationを伴うOAuth 2.1を使用するため、開始時にAPIキーを貼り付ける必要はありません。
ユーザーはWorkOS CLIを介して、Claude Code、Codex、Cursorなどのエージェントに接続できます。また、リモートserverのURLを追加することで、GitHub Copilot、VS Code、Claude Desktop、ChatGPTとも互換性があります。エージェントはユーザー固有のダッシュボードロールを継承するため、アカウントによって許可されているアクションのみを実行できます。安全のため、serverはデフォルトでsandbox環境に設定されており、組織や接続の削除といった取り消し不可能な操作には明示的な確認が必要です。
できること
- 1新しい組織のプロビジョニングエージェントに新しい組織を作成し、ファイルからユーザーグループを招待するよう指示します。
- 2SSO問題のトラブルシューティング特定の組織でサインインが困難になっている原因を調査するためにエージェントを使用します。
- 3AuthKitブランディングの更新特定のデザインに合わせてサインインページの見た目を変更するようエージェントに依頼します。
- 4ディレクトリ同期の監査下書き状態の接続がある組織や、最近同期に失敗したディレクトリを特定します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
WorkOS MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにWorkOS MCPをインストール
$ claude mcp add --transport http mcp https://mcp.workos.com/mcpCursorにWorkOS MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.workos.com/mcp"
}
}
}VS CodeにWorkOS MCPをインストール
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.workos.com/mcp"
}
}
}VS Code CLIにWorkOS MCPをインストール
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://mcp.workos.com/mcp"}'CodexにWorkOS MCPをインストール
$ codex mcp add mcp --url https://mcp.workos.com/mcpCodex config.tomlにWorkOS MCPをインストール
~/.codex/config.toml
[mcp_servers.mcp] url = "https://mcp.workos.com/mcp"
Gemini CLIにWorkOS MCPをインストール
$ gemini mcp add -s user --transport http mcp https://mcp.workos.com/mcpGemini settings.jsonにWorkOS MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.workos.com/mcp",
"type": "http"
}
}
}WorkOS MCPツール 5
READMEから検出whoamilist_operationsquerymutatesetup_account
| whoami | — | |
| list_operations | — | |
| query | — | |
| mutate | — | |
| setup_account | — |
自動チェック
実行日 2026年11月12日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)合格
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない未チェック
- リモートエンドポイントがHTTPSを使用合格
- 破壊的なツールがラベル付けされている合格
- モデルへの隠れた指示がない合格
- パッケージおよびその依存関係に重大な勧告なし未チェック
README
GitHubで見るWorkOS MCP Server
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.
- Server URL:
https://mcp.workos.com/mcp - Transport: Streamable HTTP
- Auth: OAuth 2.1 with Dynamic Client Registration (WorkOS Connect). No API keys to paste.
- Docs: https://workos.com/docs/mcp
This folder holds the registry metadata (server.json) for the server. The
server runs as a hosted service at WorkOS. Its source is not published here.
The rest of this repository holds WorkOS skills for AI coding agents.
The server acts as you. It inherits your WorkOS dashboard role and can only do what your account can do.
Connect a client
The first time you connect, your client opens a WorkOS consent screen. Sign in and approve access. After that the agent is connected as your account.
WorkOS CLI (Claude Code, Codex, Cursor)
workos mcp install
The CLI detects installed clients. Use --agent claude-code, --agent codex,
or --agent cursor to target one. workos mcp status shows what is installed
and signed in.
GitHub Copilot / VS Code
Add the server to .vscode/mcp.json:
{
"servers": {
"workos": {
"type": "http",
"url": "https://mcp.workos.com/mcp"
}
}
}
Start the server from the mcp.json editor, or run MCP: List Servers from
the Command Palette.
Claude Code
claude mcp add --transport http workos https://mcp.workos.com/mcp
Use /mcp inside Claude Code to check status or sign in again.
Cursor
Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project):
{
"mcpServers": {
"workos": { "url": "https://mcp.workos.com/mcp" }
}
}
Open Settings → MCP and click Login next to WorkOS.
Codex CLI
codex mcp add workos --url https://mcp.workos.com/mcp
codex mcp login workos
Claude Desktop, ChatGPT
Open Settings → Connectors, click Add custom connector, name it
WorkOS, and enter https://mcp.workos.com/mcp.
Other clients
Add a remote MCP server with the URL https://mcp.workos.com/mcp. Setup steps
for Antigravity, Factory, Goose, OpenCode, Windsurf, and Zed are in the
docs.
Tools
| Tool | What it does |
|---|---|
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. |
Operations cover organizations, users, SSO connections, Directory Sync, AuthKit branding, webhooks, feature flags, and more.
Example prompts
- "Set up a new organization for Acme Corp and invite everyone in
acme_employees.csv." - "Help me understand why
org_123is having trouble signing in with SSO." - "Invite
bob@example.comtoorg_123as an admin." - "List every organization with a draft SSO connection, and flag any directories that haven't synced in 24 hours."
- "Here's a screenshot of our marketing site. Make our AuthKit sign-in page match it."
- "Set up a Datadog audit log stream for our production environment."
Permissions and safety
- Role inheritance. The agent runs every operation through the same access controls as the dashboard. A read-only role cannot make changes.
- Environment scope. The agent works in one environment at a time. It defaults to a sandbox environment and only touches production when you say so.
- Destructive confirmation. Irreversible operations, such as deleting an organization, connection, or directory, return a description of what will be destroyed and require an explicit confirmation step before they run.
- Secrets. API keys, client secrets, and similar values are stripped from responses before they reach the agent.
- Admin controls. Team admins can disable MCP access, block production access, or make MCP read-only for the whole team from the team authentication settings.
Limitations
- No user impersonation.
- The most sensitive dashboard actions are not exposed: changing MCP access settings, minting or rotating credentials, and deleting your WorkOS team.
- One team at a time. The agent is scoped to the team you authenticate with.
Support
- Docs: https://workos.com/docs/mcp
- Support: support@workos.com
- Status: https://status.workos.com
Listings
server.json here is the source of truth for the com.workos/mcp entry in the
MCP Registry. Other directories are
tracked in LISTINGS.md.
WorkOS MCPのよくある質問
WorkOS MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --transport http mcp https://mcp.workos.com/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
WorkOS MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
WorkOS MCPが提供するツールは
5個のツールを提供しており、whoami, list_operations, query, mutate, setup_accountなどがあります。
WorkOS MCP serverはどのように認証しますか?
WorkOS Connectを介したDynamic Client RegistrationによるOAuth 2.1を使用します。そのため、APIキーを貼り付ける代わりに、同意画面を通じてサインインします。
WorkOS MCP agentにはどのような権限がありますか?
エージェントはユーザーのアカウントとして動作し、ダッシュボードのロールを継承します。そのため、読み取り専用ロールでは変更を行うことはできません。一度に一つの環境でのみ動作し、デフォルトではsandboxが指定されます。
WorkOS MCP serverで何ができますか?
組織、ユーザー、SSO接続、Directory Sync、AuthKitのブランディング、webhook、およびfeature flagsに関する読み取りおよび書き込み操作を実行できます。
WorkOS MCPは破壊的な操作の際に確認が必要ですか?
はい。組織、接続、またはディレクトリの削除といった取り消し不可能な操作では、削除される内容の説明が返され、事前に明示的な確認が求められます。