Skip to content
WorkOS

WorkOSMCP Server

Released
6 views
v0.1.0

Summary

WorkOS's official remote MCP server — run your WorkOS dashboard from an agent: organizations, users, SSO connections, Directory Sync, AuthKit branding and audit log streams.

Features

  • Manage organizations, users, SSO connections and Directory Sync
  • Edit AuthKit branding and configure audit log streams
  • Agent inherits your exact dashboard role — never more access than you have
  • Environment-scoped and sandbox by default; production only on request
  • Destructive operations require explicit confirmation after a described impact
  • API keys and client secrets stripped from responses before reaching the model
  • Team-level admin switches: enable, allow production, allow write
  • OAuth over streamable HTTP; 15+ documented clients

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

  1. Open your agent's MCP configuration file.
  2. Merge the snippet below into it.
  3. Restart the agent — the "WorkOS" tools will be available.
{
  "mcpServers": {
    "workos": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.workos.com/mcp"
      ]
    }
  }
}

Description

WorkOS MCP is a remote management server at https://mcp.workos.com/mcp that hands an AI agent the same WorkOS dashboard you use — organizations, users, SSO connections, Directory Sync, AuthKit branding, audit logs — and lets it call the WorkOS API on your behalf. Ask it to onboard a customer from a CSV, work out why org_123 cannot complete an SSO sign-in, or set up a Datadog audit log stream, and it works out which operations to run.

The permission model is the reason to look at it. The agent authenticates as you, over OAuth via WorkOS Connect, and inherits your exact dashboard role — a member without admin rights cannot use it to do admin-only things, and a read-only role cannot change anything. It is scoped to one environment at a time and defaults to sandbox, only touching production when you direct it there. Irreversible operations (deleting an organization, connection or directory) are never executed on the first attempt: the agent gets a description of exactly what would be destroyed and has to confirm. API keys, client secrets and signing certificates are stripped from responses before they reach the model's context, so a secret cannot leak into a chat transcript — though the agent can still set a value you supply.

Admin controls. Team admins get three independent switches in team authentication settings, all on by default: enable MCP at all, allow production access, and allow write access. Turning off write access makes the whole surface read-only for everyone.

Deliberate gaps. No user impersonation is exposed and mutations are blocked on impersonated sessions; the agent cannot change the MCP access settings that govern itself, mint or rotate credentials, or delete your WorkOS team; and it is scoped to the single team you authenticate with.

Clients. Streamable HTTP with OAuth, documented for Claude Code, Claude Desktop, ChatGPT (Pro, Business and Enterprise custom connectors), Cursor, VS Code, Zed, Windsurf, Codex CLI, Factory, Goose, OpenCode and Antigravity — 15+ in total, plus any other client that accepts a remote MCP URL.

Related MCP Servers

New

Arm's official MCP server for porting and tuning software on Arm — semantic docs search, codebase migration scanning, container architecture checks and LLVM-MCA assembly analysis.

New

Official AntV MCP server that turns a description of your data into a rendered chart — 26 visualization types from bar and line to sankey, mind-map, fishbone and geographic maps.

MCP: Headroom

by Headroom Labs

New

Context-compression MCP server that shrinks tool outputs, logs, files and RAG chunks before they reach the model, cutting 60-95% of tokens on JSON payloads.

MCP: Engram

by Gentleman Programming

New

Persistent memory for coding agents as a single Go binary — SQLite and FTS5 behind MCP, an HTTP API, a CLI and a TUI, with no Node, Python or Docker required.

Browse all MCP servers →