WorkOS MCP Server
Manage your WorkOS workspace with AI agents. The WorkOS MCP server lets any Model Context Protocol client manage organizations, users, SSO connections, and more.
The WorkOS MCP server is a remote management Model Context Protocol server that lets MCP-compatible AI agents act on your WorkOS workspace. Once connected, your agent can read and change the same dashboard data you can (managing organizations, connections, users, branding, and more) by calling the WorkOS API on your behalf.
If you are instead building your own MCP server and want to secure it with OAuth, see AuthKit for MCP.
The MCP server acts as you: it inherits your dashboard role and can only do what your account is allowed to do. See Permissions for details.
Every client connects over streamable HTTP and authenticates with OAuth using WorkOS Connect. The first time you connect, your client opens a WorkOS consent screen where you sign in and approve access. After you approve, the agent is connected as your account.
Pick your client below for setup steps.
Open the MCP settings and add a new server with the URL https://mcp.workos.com/mcp, or add it to the MCP config directly:
Complete the OAuth consent when prompted to finish connecting.
- Open Settings → Connectors (available on ChatGPT Pro, Business, and Enterprise).
- Click Add custom connector (you may need to enable developer mode first).
- Name it
WorkOSand enter the MCP server URLhttps://mcp.workos.com/mcp. - Complete the OAuth consent to finish connecting.
Run the following, then complete the OAuth consent in your browser to finish connecting:
Use /mcp inside Claude Code to check the connection status or sign in again.