WorkOS Connector for AI agents.
10 live capabilities
Manage enterprise identity and SSO connections through natural conversation.
Waiting for input…
Why people use WorkOS
WorkOS for Enterprise Identity Management
This Connector changes that by giving your agent a direct line to your WorkOS data. You can ask about connection health, list user rosters, or audit logs in plain English. You get your answers in a single chat window without ever leaving your workspace.
What Vinkius changes
You get an identity admin that works through a chat interface.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Troubleshooting a broken login
An engineer asks the agent to check the status of an OIDC connection for a specific company.
- Real-world use case 02
Security audit
A compliance officer asks for all audit logs from the last hour for a specific organization.
- Real-world use case 03
Onboarding a new client
A product manager needs to create a new organization with five specific domains.
Complete set · 10capabilities
The complete WorkOS capability set.
These are the exact actions your AI can choose when you ask it to work with WorkOS.
01—04
4 capabilities in this set.
Part of 10 available through WorkOS.
- 01 Capability
Get audit log events
Retrieve a stream of security and compliance events for a specific organization. Use this to monitor recent activity for security checks.
- 02 Capability
Get sso connection details
Pull specific metadata and status info for a single SSO connection. This is great for checking if a SAML or OIDC link is active.
- 03 Capability
Get directory details
Get metadata for a specific directory instance like Okta or Azure AD. This helps you verify the status of your directory syncs.
- 04 Capability
Get organization details
Fetch the full details for a specific organization record. Use this to see all the configuration data for a single tenant.
05—07
3 capabilities in this set.
Part of 10 available through WorkOS.
- 05 Capability
List sso connections
List all active SAML and OIDC connections in your account. This gives you a bird's eye view of your enterprise connections.
- 06 Capability
List directories
View all active Directory Sync instances currently in use. Use this to check the status of your HRIS and SCIM connections.
- 07 Capability
Create workos organization
Create a new organization record with a name and a list of authorized domains. This helps you set up new enterprise tenants quickly.
08—10
3 capabilities in this set.
Part of 10 available through WorkOS.
- 08 Capability
List directory groups
See all groups currently synced from an external directory. This is useful for auditing user permissions and access.
- 09 Capability
List workos organizations
Get a complete list of all organizations in your WorkOS account. Use this to find specific organization IDs without manual searching.
- 10 Capability
List directory users
List all users currently synced from a directory. This allows you to pull a full roster of users into your chat quickly.
Set up in minutes
One URL. Then ask WorkOS to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use WorkOS from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_rwxMA9lZDQOsPAB4YWRqrtYcwkF7I80gqKgTYNRP/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it WorkOS, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable WorkOS for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_rwxMA9lZDQOsPAB4YWRqrtYcwkF7I80gqKgTYNRP/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the WorkOS URL.
- Step 03
Save and start
Save the connection and enable WorkOS in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"workos": {
"url": "https://edge.vinkius.com/vk_preview_rwxMA9lZDQOsPAB4YWRqrtYcwkF7I80gqKgTYNRP/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using WorkOS
Open Agent mode in chat and ask: "Using WorkOS, help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"workos": {
"url": "https://edge.vinkius.com/vk_preview_rwxMA9lZDQOsPAB4YWRqrtYcwkF7I80gqKgTYNRP/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using WorkOS
Ask Copilot: "Using WorkOS, help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"workos": {
"url": "https://edge.vinkius.com/vk_preview_rwxMA9lZDQOsPAB4YWRqrtYcwkF7I80gqKgTYNRP/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using WorkOS
Open Cascade and ask: "Using WorkOS, help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"workos": {
"url": "https://edge.vinkius.com/vk_preview_rwxMA9lZDQOsPAB4YWRqrtYcwkF7I80gqKgTYNRP/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using WorkOS
Ask Cline: "Using WorkOS, help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add workos --transport http "https://edge.vinkius.com/vk_preview_rwxMA9lZDQOsPAB4YWRqrtYcwkF7I80gqKgTYNRP/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using WorkOS
Ask Claude: "Using WorkOS, show me...". 10 tools are ready
Where the request belongs
Work WorkOS can move forward.
It's for the identity engineer who spends half their day in a dashboard, the security lead hunting for audit logs, and the support agent trying to find a user's org details quickly.
Enterprise Engineer
Troubleshoots SSO connection health and directory sync issues via chat on a Tuesday afternoon.
Security & Compliance Lead
Monitors audit logs and verifies user group access to ensure company security standards.
Product Manager
Audits verified domains and organization records for roadmap and launch planning.
Support Specialist
Looks up organization details and user rosters to provide rapid technical assistance to customers.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsBoxyHQ (Enterprise SSO)
Manage Enterprise SSO and Directory Sync (SCIM) via BoxyHQ. configure SAML/OIDC connections and automate user provisioning directly from your AI agent.
Atlassian Crowd
Equip your AI agent to manage users, groups, and directory memberships via the Atlassian Crowd API.
Okta
Equip your AI agent with Okta Identity Cloud to manage users, groups, and seamless authentication effortlessly.
PropelAuth (B2B Authentication)
Manage B2B authentication, users, and organizations via PropelAuth. handle user provisioning, org management, and API keys directly from your AI agent.
Sapling (Kallidus)
Manage employee onboarding, data, and tasks via Sapling API.
Personio
Orchestrate HR logistics via Personio. manage workforce lists, track specific absences, log attendances securely, and evaluate custom attributes structurally via AI.
Bring your own AI
Change the model, client or framework. Keep WorkOS connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about WorkOS.
The practical details behind the request, access and result.
What does the WorkOS MCP do for my AI agent?
It connects your AI agent to your WorkOS account so you can manage organizations, SSO connections, and directory syncs using natural language commands.
Can I use the WorkOS MCP to manage SAML and OIDC connections?
Yes. You can use your agent to list all active connections, check their current health status, and retrieve specific metadata for any SSO link.
Does the WorkOS MCP support Okta and Azure AD directory syncs?
Yes. It allows your agent to monitor active sync instances and pull deep details on the status of your HRIS and SCIM directory connections.
Can I use WorkOS MCP to check security audit logs?
Yes. Your agent can stream audit log events for any organization to help you monitor security activities and maintain compliance.
Is the WorkOS MCP good for support teams?
It is excellent for support. It lets your team quickly look up organization details and user rosters to provide faster technical assistance to customers.
How does the WorkOS MCP help with enterprise onboarding?
It allows your agent to create new organization records and manage authorized domains, making it much faster to set up new enterprise tenants.
Can I check the sync status of a specific company directory through the agent?
Yes. The get_directory_details capability allows your AI agent to retrieve the current sync status and metadata for any specific directory ID, helping you monitor whether employees are being correctly provisioned.
How do I see which users belong to a specific synced group?
You can use the list_directory_users capability and filter by the directory ID to see the full roster. For group-level information, use the list_directory_groups capability to see organizational units imported from the identity provider.
Is it possible to retrieve security audit logs via chat?
Absolutely. The get_audit_log_events capability retrieves a stream of events for any specific organization ID, giving you instant access to compliance-related activities directly through your conversation.
One connection away
Give your agent a direct line to WorkOS.
Connect WorkOS once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available