Gestiona organizaciones, usuarios, conexiones SSO, directorios y el branding de AuthKit de WorkOS a través de la API de WorkOS.
También conocido como workos/skills, mcp
- Stars
- 46
- Herramientas
- 5
- Descargas, 30 días
- —
- Última versión
- 1.0.0
- Último commit
- 2 nov 2026
- Licencia
- MIT
¿Qué es WorkOS MCP?
Gestiona organizaciones, usuarios, conexiones SSO, directorios y el branding de AuthKit de WorkOS a través de la API de WorkOS. Expone 5 herramientas, como whoami, list_operations, query.
Resumen generado a partir del README del proyecto
Acerca del MCP server de WorkOS
Gestionar organizaciones, usuarios y conexiones SSO de WorkOS mediante un agente de IA es posible con este MCP server remoto. Permite a los desarrolladores controlar la configuración del espacio de trabajo, la sincronización de directorios, el branding de AuthKit y los webhooks llamando directamente a la API de WorkOS desde su cliente de IA preferido. El servidor funciona como un servicio alojado y utiliza OAuth 2.1 con Dynamic Client Registration, lo que significa que no necesitas pegar ninguna clave de API para empezar.
Los usuarios pueden conectarse a través de la WorkOS CLI para dirigirse a agentes como Claude Code, Codex o Cursor. También es compatible con GitHub Copilot, VS Code, Claude Desktop y ChatGPT añadiendo la URL del servidor remoto. El agente hereda tu rol específico del dashboard, asegurando que solo pueda realizar las acciones permitidas por tu cuenta. Por seguridad, el servidor utiliza por defecto un entorno de sandbox y requiere confirmación explícita para operaciones irreversibles, como eliminar una organización o una conexión.
Qué puedes hacer con él
- 1Aprovisionamiento de nuevas organizacionesPide al agente que cree una nueva organización e invite a un grupo de usuarios desde un archivo.
- 2Resolución de problemas de SSOUtiliza el agente para investigar por qué una organización específica está teniendo dificultades para iniciar sesión.
- 3Actualización del branding de AuthKitSolicita al agente que modifique la apariencia de tu página de inicio de sesión para que coincida con un diseño específico.
- 4Auditoría de la sincronización de directoriosIdentifica organizaciones con conexiones en borrador o directorios que no se han sincronizado correctamente recientemente.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar WorkOS MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar WorkOS MCP en Claude Code
$ claude mcp add --transport http mcp https://mcp.workos.com/mcpInstalar WorkOS MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.workos.com/mcp"
}
}
}Instalar WorkOS MCP en VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.workos.com/mcp"
}
}
}Instalar WorkOS MCP en VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://mcp.workos.com/mcp"}'Instalar WorkOS MCP en Codex
$ codex mcp add mcp --url https://mcp.workos.com/mcpInstalar WorkOS MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] url = "https://mcp.workos.com/mcp"
Instalar WorkOS MCP en Gemini CLI
$ gemini mcp add -s user --transport http mcp https://mcp.workos.com/mcpInstalar WorkOS MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.workos.com/mcp",
"type": "http"
}
}
}Herramientas de WorkOS MCP 5
Detectado desde el READMEwhoamilist_operationsquerymutatesetup_account
| whoami | — | |
| list_operations | — | |
| query | — | |
| mutate | — | |
| setup_account | — |
Verificaciones automáticas
Ejecutado 12 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleAprobado
- Licencia de código abierto (OSI)Aprobado
- Commit o lanzamiento en el último añoAprobado
- El nombre del paquete no es similar a un paquete popularNo verificado
- El endpoint remoto usa HTTPSAprobado
- Las herramientas destructivas están etiquetadasAprobado
- Sin instrucciones ocultas para el modeloAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
README
Ver en GitHubWorkOS 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.
Preguntas sobre WorkOS MCP
¿Cómo agrego WorkOS MCP a Claude Code?
Ejecuta claude mcp add --transport http mcp https://mcp.workos.com/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego WorkOS MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona WorkOS MCP?
Expone 5 herramientas, incluidas whoami, list_operations, query, mutate, setup_account.
¿Cómo se autentica el MCP server de WorkOS?
Utiliza OAuth 2.1 con Dynamic Client Registration a través de WorkOS Connect, por lo que inicias sesión mediante una pantalla de consentimiento en lugar de pegar claves de API.
¿Qué permisos tiene el agente MCP de WorkOS?
El agente actúa en tu nombre y hereda tu rol del dashboard; por lo tanto, un rol de solo lectura no podrá realizar cambios. Funciona en un solo entorno a la vez y utiliza un sandbox por defecto.
¿Qué puede hacer el MCP server de WorkOS?
Ejecuta operaciones de lectura y escritura que cubren organizaciones, usuarios, conexiones SSO, Directory Sync, branding de AuthKit, webhooks y feature flags.
¿Requiere WorkOS MCP confirmación para acciones destructivas?
Sí, las operaciones irreversibles como eliminar una organización, conexión o directorio devuelven una descripción de lo que se va a destruir y requieren una confirmación explícita previa.