How to Use the WorkOS MCP in Cline

Q: How do I build a feature using WorkOS with Cline?

You write code that calls specific tools like getorganizationdetails or listworkosorganizations. Cline then executes this logic, allowing you to test the data retrieval end-to-end.

Q: What is the best way to check organization setup with WorkOS in Cline?

Start by listing all organizations using listworkosorganizations. Then, if you need deeper context, call getorganizationdetails on a specific ID. This forms a clean data pipeline for your code.

Q: Can I use the MCP Server with WorkOS to validate user access in Cline?

Yes. You pull users via listdirectoryusers, and then you can cross-reference them by listing groups using listdirectorygroups. This lets your code verify complex permissions.

Build enterprise features using WorkOS APIs with Cline.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect WorkOS MCP to Cline

Create your Vinkius account to connect WorkOS to Cline and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup WorkOS with Cline

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Create Directory Sync Components

Need to build a component that validates directory setup? You can use `list_directories` to get all current sync instances. Then, you write code that calls `get_directory_details` on each one to ensure the metadata matches your requirements. Cline lets you run tests against this logic, guaranteeing your dashboard only shows accurate WorkOS data.

Code SSO Connection Handlers

Writing a module that checks connectivity? Use `list_sso_connections` to pull all active connections. From there, you can call `get_sso_connection_details` on specific IDs. Cline helps you write the code that handles success or failure states. This makes building connection status checkers straightforward and reliable.

Generate User Reporting Tools

Want a report showing user roles? Use `list_directory_users` to pull all synced accounts. Follow that up by calling `list_directory_groups` to map those users to their groups. Cline handles the heavy lifting: it takes these lists, builds the necessary data structure, and stages the component file for you.

Setup guide

Set up WorkOS MCP in Cline

Prerequisites

VS Code with Cline extension installed
Active Vinkius subscription with a valid endpoint token

1

Open Cline MCP settings

Click the Cline icon in the VS Code sidebar to open the Cline panel. Then click the MCP Servers icon (server stack) at the top-right corner of the panel.
2

Add a remote server

Click "Remote Servers" at the top, then click "Add Remote MCP". In the Name field, type workos-mcp. In the URL field, paste your Vinkius endpoint: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp. Get your token from cloud.vinkius.com.
3

Enable the server

After saving, the server appears in the Cline MCP panel. Toggle the switch to enable it. The status indicator turns green when the connection is live.
4

Start using tools

Return to the Cline chat and ask: "Check my latest WorkOS refund status." Cline will discover the available tools and request your approval before invoking each one — giving you full control over every action.

Cline MCP Settings

{
  "mcpServers": {
    "workos-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by WorkOS. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect WorkOS now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about WorkOS MCP in Cline

You write code that calls specific tools like `get_organization_details` or `list_workos_organizations`. Cline then executes this logic, allowing you to test the data retrieval end-to-end.

Start by listing all organizations using `list_workos_organizations`. Then, if you need deeper context, call `get_organization_details` on a specific ID. This forms a clean data pipeline for your code.

Yes. You pull users via `list_directory_users`, and then you can cross-reference them by listing groups using `list_directory_groups`. This lets your code verify complex permissions.

You'll use the API through Cline. First, list all existing SSO connections with `list_sso_connections`, and then call `get_sso_connection_details` to pull the current configuration.

This server touches organizational directory metadata, including user lists, group memberships, SSO connection records, and organization details.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python