README.md

WorkOS MCP Server

MCP server for WorkOS User Management API. Enables Claude to manage users, organizations, memberships, invitations, and sessions in WorkOS.

Installation

bun install

Configuration

Set environment variables:

export WORKOS_API_KEY=sk_...
export WORKOS_CLIENT_ID=client_...
export WORKOS_ENVIRONMENT_ID=environment_...  # Found in WorkOS Dashboard URL

Usage

With Claude Code

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "workos": {
      "command": "bun",
      "args": ["run", "/path/to/packages/mcps/workos/src/index.ts"],
      "env": {
        "WORKOS_API_KEY": "sk_...",
        "WORKOS_CLIENT_ID": "client_...",
        "WORKOS_ENVIRONMENT_ID": "environment_..."
      }
    }
  }
}

Standalone

bun run src/index.ts

Inspect with MCP Inspector

bun run inspect

Available Tools

User Management

Tool	Description
list_users	List users with optional filtering by email or organization
get_user	Get details of a specific user
create_user	Create a new user
update_user	Update user information
delete_user	Delete a user

Organizations

Tool	Description
list_organizations	List all organizations
get_organization	Get organization details
create_organization	Create a new organization
update_organization	Update organization
delete_organization	Delete an organization

Organization Memberships

Tool	Description
list_organization_memberships	List memberships (filter by user or org)
get_organization_membership	Get membership details
create_organization_membership	Add user to organization
update_organization_membership	Update user's role
delete_organization_membership	Remove user from organization

Invitations

Tool	Description
list_invitations	List pending invitations
get_invitation	Get invitation details
send_invitation	Send invitation email
revoke_invitation	Revoke pending invitation

Sessions

Tool	Description
list_sessions	List active sessions for a user
revoke_session	Revoke an active session

Password & Verification

Tool	Description
send_password_reset_email	Send password reset email
send_verification_email	Send email verification

MFA

Tool	Description
list_auth_factors	List user's MFA factors

Impersonation (Dashboard Links)

Tool	Description
get_impersonation_url	Get URL to impersonate user in WorkOS Dashboard
get_user_dashboard_url	Get URL to view user in WorkOS Dashboard

License

MIT