workos-mcp

Lightweight MCP server to give your Cursor Agent access to the WorkOS API.

Catalog onlyCatalog onlySTDIO

Overview

workos-mcp is a lightweight Model Control Protocol (MCP) server that enables Cursor Agents to interact with the WorkOS API, facilitating seamless integration and communication.

To use workos-mcp, clone the repository using the automated install script, configure your Cursor settings, and upload your WorkOS API key and client ID as secrets.

Lightweight MCP server for easy deployment on Cloudflare Workers - Integration with WorkOS API for enhanced functionality - Ability to create custom MCP tools by adding methods to the server

Enabling Cursor Agents to access WorkOS functionalities.
Creating custom tools for specific tasks within the MCP framework.
Facilitating communication between agents and the WorkOS API.

Add to your AI client

Use these steps to connect workos-mcp in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "workos-mcp-zueai": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-workos-mcp-zueai"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "workos-mcp-zueai": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-workos-mcp-zueai"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "workos-mcp-zueai": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-workos-mcp-zueai"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "workos-mcp-zueai": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-workos-mcp-zueai"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "workos-mcp-zueai": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-workos-mcp-zueai"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "workos-mcp-zueai": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-workos-mcp-zueai"
      ]
    }
  }
}

FAQ

What is the purpose of workos-mcp?

It serves as a bridge for Cursor Agents to interact with the WorkOS API.

How do I deploy workos-mcp?

Use the provided install script and follow the configuration steps outlined in the documentation.

Can I create my own MCP tools?

Yes! You can add methods to the MyWorker class to create custom tools.

Developer tools