WorkOS · Gemini CLI

Add the WorkOS MCP server to Gemini CLI

Manage WorkOS organizations, users, SSO, Directory Sync and AuthKit.

Official serverRemoteAuthentication

1. Add the server

Run in your terminal

gemini mcp add --transport http workos https://mcp.workos.com/mcp

2. Sign in

Run /mcp auth <name> inside Gemini CLI to sign in to an OAuth server. WorkOS is hosted by WorkOS, so there is nothing to install or keep updated.

3. Try it

Ask Gemini CLI for something WorkOS can do. Manage WorkOS organizations, users, SSO, Directory Sync and AuthKit. Approve the first tool call and check the result before allowing write actions automatically.

· In settings.json, streamable HTTP servers use httpUrl, SSE servers use url, local servers use command.
· includeTools and excludeTools limit which tools the model sees.

FAQ

How do I add the WorkOS MCP server to Gemini CLI?: Run: gemini mcp add --transport http workos https://mcp.workos.com/mcp. Run /mcp auth <name> inside Gemini CLI to sign in to an OAuth server.
Is this the official WorkOS MCP server?: Yes. It is published by WorkOS as com.workos/mcp in the official MCP registry.
Does the WorkOS MCP server need an API key?: It is a hosted server. Most hosted servers sign you in with OAuth the first time Gemini CLI uses them; check WorkOS's docs for any plan or permission requirements.

Links

WorkOS MCP docs Gemini CLI MCP docs WorkOS server details

WorkOS in other clients

Claude Code Codex Cursor VS Code (GitHub Copilot)

More authentication for Gemini CLI

Auth0 Clerk

Work at WorkOS?

Feature WorkOS across the directory and its category from $49/month.

Feature this server

Reviewed Oct 5, 2026. Command generated from the registry record and checked against Gemini CLI's documented syntax.