Verwalte WorkOS-Organisationen, User, SSO-Verbindungen, Directories und AuthKit-Branding über die WorkOS API.
Auch bekannt als workos/skills, mcp
- Stars
- 46
- Tools
- 5
- Downloads, 30 Tage
- —
- Neueste Version
- 1.0.0
- Letzter Commit
- 2. Nov. 2026
- Lizenz
- MIT
Was ist WorkOS MCP?
WorkOS ist ein MCP server. Verwalte WorkOS-Organisationen, User, SSO-Verbindungen, Directories und AuthKit-Branding über die WorkOS API. Er stellt 5 Tools bereit, etwa whoami, list_operations, query.
Zusammenfassung generiert aus dem README des Projekts
Über WorkOS MCP server
Mit diesem Remote MCP server kannst du WorkOS-Organisationen, User und SSO-Verbindungen direkt über einen AI Agent verwalten. Er ermöglicht es Entwicklern, Workspace-Einstellungen, Directory Sync, AuthKit-Branding und Webhooks zu steuern, indem sie die WorkOS API direkt aus ihrem bevorzugten AI Client aufrufen. Der Server läuft als Hosted Service und nutzt OAuth 2.1 mit Dynamic Client Registration, sodass du keine API-Keys kopieren und einfügen musst, um loszulegen.
User können sich via WorkOS CLI mit Agenten wie Claude Code, Codex oder Cursor verbinden. Er ist zudem kompatibel mit GitHub Copilot, VS Code, Claude Desktop und ChatGPT, indem einfach die Remote-Server-URL hinzugefügt wird. Der Agent übernimmt deine spezifische Dashboard-Rolle und stellt so sicher, dass er nur Aktionen ausführen kann, die deinem Account erlaubt sind. Zur Sicherheit nutzt der Server standardmäßig ein Sandbox-Environment und verlangt eine explizite Bestätigung für irreversible Operationen, wie das Löschen einer Organisation oder Verbindung.
Was du damit machen kannst
- 1Provisionierung neuer OrganisationenBitte den Agenten, eine neue Organisation zu erstellen und eine Gruppe von Usern aus einer Datei einzuladen.
- 2Fehlersuche bei SSO-ProblemenNutze den Agenten, um zu untersuchen, warum eine bestimmte Organisation Probleme beim Sign-in hat.
- 3Aktualisierung des AuthKit-BrandingsFordere den Agenten auf, das Design deiner Sign-in-Seite anzupassen, um einem spezifischen Design zu entsprechen.
- 4Audit von Directory-SynchronisationenIdentifiziere Organisationen mit Draft-Verbindungen oder Directories, deren Sync kürzlich fehlgeschlagen ist.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du WorkOS MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenWorkOS MCP in Claude Code installieren
$ claude mcp add --transport http mcp https://mcp.workos.com/mcpWorkOS MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.workos.com/mcp"
}
}
}WorkOS MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.workos.com/mcp"
}
}
}WorkOS MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://mcp.workos.com/mcp"}'WorkOS MCP in Codex installieren
$ codex mcp add mcp --url https://mcp.workos.com/mcpWorkOS MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.mcp] url = "https://mcp.workos.com/mcp"
WorkOS MCP in Gemini CLI installieren
$ gemini mcp add -s user --transport http mcp https://mcp.workos.com/mcpWorkOS MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.workos.com/mcp",
"type": "http"
}
}
}WorkOS MCP tools 5
Erkannt aus dem READMEwhoamilist_operationsquerymutatesetup_account
| whoami | — | |
| list_operations | — | |
| query | — | |
| mutate | — | |
| setup_account | — |
Automatisierte Checks
Geluften am 12. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarBestanden
- Open Source Lizenz (OSI)Bestanden
- Commit oder Release im letzten JahrBestanden
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Remote Endpoint nutzt HTTPSBestanden
- Destruktive Tools sind markiertBestanden
- Keine versteckten Anweisungen an das ModellBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
README
Auf GitHub ansehenWorkOS 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 Fragen
Wie füge ich WorkOS MCP zu Claude Code hinzu?
Führe claude mcp add --transport http mcp https://mcp.workos.com/mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich WorkOS MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet WorkOS MCP?
Er stellt 5 Tools bereit, darunter whoami, list_operations, query, mutate, setup_account.
Wie authentifiziert sich der WorkOS MCP server?
Er nutzt OAuth 2.1 mit Dynamic Client Registration über WorkOS Connect. Du meldest dich also über einen Consent-Screen an, anstatt API-Keys manuell einzufügen.
Welche Berechtigungen hat der WorkOS MCP Agent?
Der Agent agiert in deinem Namen und übernimmt deine Dashboard-Rolle. Ein Read-only-Account kann daher keine Änderungen vornehmen. Er arbeitet immer in einer Umgebung gleichzeitig und nutzt standardmäßig ein Sandbox-Environment.
Was kann der WorkOS MCP server leisten?
Er führt Read- und Write-Operationen für Organisationen, User, SSO-Verbindungen, Directory Sync, AuthKit-Branding, Webhooks und Feature Flags aus.
Erfordert WorkOS MCP eine Bestätigung für destruktive Aktionen?
Ja, irreversible Operationen wie das Löschen einer Organisation, einer Verbindung oder eines Directorys geben eine Beschreibung dessen zurück, was gelöscht wird, und erfordern vorab eine explizite Bestätigung.