Which integrations are available for this server?

Provides tools to query and manage Clerk organizations, members, users, roles, invitations, and metadata directly from AI assistants.

How do I use Clerk MCP Server?

This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

Clerk MCP Server

by BalajiSriraman

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

Clerk MCP Server

A Model Context Protocol (MCP) server for Clerk

Query and manage your Clerk organizations, members, users, roles, and metadata directly from AI assistants like Claude, Cursor, VS Code Copilot, Windsurf, and more.

Getting Your Clerk API Key

You need a Clerk Secret Key to use this server.

Go to dashboard.clerk.com and sign in (or create an account)
Select your application (or create one)
Navigate to Configure → API Keys
Copy the Secret Key — it starts with sk_test_ (development) or sk_live_ (production)

Never commit your secret key to git. Use environment variables or pass it via headers.

Related MCP server: Bitwarden MCP Server

Two Operating Modes

The server supports two modes, auto-detected at startup:

Hosted Mode (Private)

The server owns the Clerk secret key. Set CLERK_SECRET_KEY in your .env file and all requests use that single key. No headers needed from clients.

Best for: Personal use, internal teams, self-hosted deployments.

Public Mode (Per-Request Key)

No secret key on the server. Each client passes their own key via the X-Clerk-Secret-Key HTTP header on every request. The server creates a fresh Clerk client per request.

Best for: Shared deployments, multi-tenant setups, or when you don't want the key stored on the server.

	Hosted Mode	Public Mode
Key stored on server	Yes (in `.env`)	No
Key sent per request	No	Yes (via header)
Setup complexity	Simpler	Slightly more config
Multi-user support	Single Clerk account	Multiple Clerk accounts

Quick Start

1. Clone & install

git clone https://github.com/BalajiSriraman/Clerk-MCP.git
cd Clerk-MCP
npm install

2. Configure & run

Hosted mode — set the key once on the server:

cp .env.example .env
# Edit .env and paste your secret key:
# CLERK_SECRET_KEY=sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx
npm run dev

Public mode — no .env needed, clients provide the key:

npm run dev

Your MCP endpoint is now live at https://clerk-mcp.vercel.app/mcp.

3. Verify

curl https://clerk-mcp.vercel.app/api/health

Hosted mode: {"status":"ok","mode":"hosted","clerkConnected":true}
Public mode: {"status":"ok","mode":"public","clerkConnected":null}

Connect to AI Assistants

Claude Code (CLI)

Hosted mode:

claude mcp add --transport http clerk https://clerk-mcp.vercel.app/mcp

Public mode:

claude mcp add --transport http \
  --header "X-Clerk-Secret-Key: sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  clerk https://clerk-mcp.vercel.app/mcp

Claude Desktop

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

Hosted mode:

{
  "mcpServers": {
    "clerk": {
      "command": "npx",
      "args": ["mcp-remote", "https://clerk-mcp.vercel.app/mcp"]
    }
  }
}

Public mode:

{
  "mcpServers": {
    "clerk": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://clerk-mcp.vercel.app/mcp",
        "--header",
        "X-Clerk-Secret-Key: sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      ]
    }
  }
}

Cursor

Go to Settings → MCP → Add Server:

Hosted mode:

{
  "mcpServers": {
    "clerk": {
      "url": "https://clerk-mcp.vercel.app/mcp"
    }
  }
}

Public mode:

{
  "mcpServers": {
    "clerk": {
      "url": "https://clerk-mcp.vercel.app/mcp",
      "headers": {
        "X-Clerk-Secret-Key": "sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

VS Code (GitHub Copilot)

Add to your workspace .vscode/mcp.json:

Hosted mode:

{
  "mcp": {
    "servers": {
      "clerk": {
        "url": "https://clerk-mcp.vercel.app/mcp"
      }
    }
  }
}

Public mode:

{
  "mcp": {
    "servers": {
      "clerk": {
        "url": "https://clerk-mcp.vercel.app/mcp",
        "headers": {
          "X-Clerk-Secret-Key": "sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
        }
      }
    }
  }
}

Windsurf

Add to MCP settings:

Hosted mode:

{
  "context_servers": {
    "clerk": {
      "source": "custom",
      "command": "npx",
      "args": ["mcp-remote", "https://clerk-mcp.vercel.app/mcp"],
      "env": {}
    }
  }
}

Public mode:

{
  "context_servers": {
    "clerk": {
      "source": "custom",
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://clerk-mcp.vercel.app/mcp",
        "--header",
        "X-Clerk-Secret-Key: sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      ],
      "env": {}
    }
  }
}

Docker

Build the image

docker build -t clerk-mcp .

Run in hosted mode

docker run -d -p 3000:3000 -e CLERK_SECRET_KEY=sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx clerk-mcp

Run in public mode

docker run -d -p 3000:3000 clerk-mcp

Docker Compose

Both modes are defined in docker-compose.yml:

# Hosted mode on port 3000 — set CLERK_SECRET_KEY in .env first
docker compose up clerk-mcp-hosted

# Public mode on port 3001 — no key needed on the server
docker compose up clerk-mcp-public

Available Tools

Organizations

Tool	Description
`clerk_list_organizations`	List orgs with filtering by name/slug, pagination, and member counts
`clerk_get_organization`	Get org details by ID or slug (includes metadata, timestamps)
`clerk_create_organization`	Create a new organization with name, slug, and metadata
`clerk_update_organization_metadata`	Update org public/private metadata
`clerk_delete_organization`	Delete an organization permanently (irreversible)

Members

Tool	Description
`clerk_list_organization_members`	List org members with roles, user data, and metadata
`clerk_update_member_role`	Change a member's role (e.g. `org:admin`, `org:member`)
`clerk_update_member_metadata`	Update membership public/private metadata
`clerk_remove_member`	Remove a member from an organization

Invitations

Tool	Description
`clerk_list_organization_invitations`	List invitations by status (pending/accepted/revoked)
`clerk_create_invitation`	Invite a user to an org by email

Users

Tool	Description
`clerk_list_users`	List all instance users with search by name/email/phone
`clerk_get_user`	Get full user profile: emails, phones, external accounts, metadata
`clerk_update_user_metadata`	Update user public/private/unsafe metadata

Example Prompts

Once connected, try asking your AI assistant:

List all organizations in my Clerk instance.
How many members does the "engineering" organization have?
Create a new organization called "Design Team" with slug "design-team".
Show me all pending invitations for organization org_2abc123.
Find all users with email addresses containing "@example.com".
Update the public metadata for user user_2xyz789 to set plan: "pro".

Deploying to Production

Build and deploy as any Nuxt/Node.js app:

npm run build
node .output/server/index.mjs

Or use Docker:

docker build -t clerk-mcp .
docker run -p 3000:3000 -e CLERK_SECRET_KEY=sk_live_xxx clerk-mcp

If you self-host, use your own deployment URL instead of https://clerk-mcp.vercel.app in the client configs above.

Compatible with: Vercel, Netlify, Cloudflare Workers (with nitro preset), Railway, Fly.io, or any Node.js host.

Adding New Tools

Create a new file in server/mcp/tools/ — it's automatically discovered by the MCP toolkit:

// server/mcp/tools/clerk-my-new-tool.ts
import { z } from "zod";

export default defineMcpTool({
  name: "clerk_my_new_tool",
  description: "Description of what this tool does",
  inputSchema: {
    param: z.string().describe("Parameter description"),
  },
  annotations: {
    readOnlyHint: true,
    destructiveHint: false,
    openWorldHint: true,
  },
  async handler({ param }) {
    const clerk = useClerkClient();
    const result = await clerkCall(() => clerk.someApi.someMethod({ param }));
    return jsonResult(result);
  },
});

Tech Stack

Nuxt 4 — Full-stack Vue framework
@nuxtjs/mcp-toolkit — MCP server module for Nuxt
@clerk/backend — Clerk Backend SDK
Zod — Schema validation

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

This server cannot be deployed

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

ClerkA
io.github.clerk
Clerk is an authentication and user management platform. Its MCP server lets coding agents set up and manage Clerk without leaving the editor. Agents can pull SDK snippets, quickstarts, and Clerk’s agent skills. They can also create apps, update instance settings, and manage users and organizations. To go live, they can create a production instance and check its domain. Sign in with any Clerk account, including a free one. Secret keys are never returned in plain text.
Developer Tools Documentation Access Security
352
https://mcp.clerk.com/mcp
hithereiamaliff-mcp-nextcloud
ai.smithery
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Cloud Storage File Systems Workplace & Productivity
239
https://server.smithery.ai/@hithereiamaliff/mcp-nextcloud/mcp
GreatArrow.ai
ai.greatarrow
Stop copy-pasting client context into your AI. 48 connectable providers via MCP.
Knowledge & Memory
1
https://www.greatarrow.ai/api/mcp
Proofable MCPB
io.github.proofable
Context and control for any AI. Agent identity, scoped access, and proof across tools.
Security Agent Orchestration Autonomous Agents
351
https://mcp.proofable.me/mcp

Related MCP Servers

Fireblocks MCP Serverofficial
Blockchain Cryptocurrency
fireblocks
A
license
Not graded
quality
D
maintenance
Enables AI assistants to securely interact with Fireblocks services through the Model Context Protocol, supporting transaction management, vault and exchange account queries, network connections, and workspace user management.
Updated a year ago (2025-09-04 21:27 UTC)
75 npm
10
MIT
Bitwarden MCP Serverofficial
Security
bitwarden
A
license
B
quality
C
maintenance
Enables AI assistants to securely manage Bitwarden vault items, folders, attachments, and organization administration through the Model Context Protocol.
Updated 2 days ago (2026-11-09 20:49 UTC)
59
1,877 npm
316
GPL 3.0
posthog-mcp-server
Feature Flags Monitoring
friendlygeorge
A
license
A
quality
F
maintenance
Connects AI assistants to PostHog to query events, persons, insights, dashboards, feature flags, cohorts, and experiments through the Model Context Protocol.
Updated 5 months ago (2026-06-06 13:06 UTC)
13
65 npm
MIT
Seeder MCP Server
Project Management Workplace & Productivity
caoxuandungecom
A
license
Not graded
quality
B
maintenance
Enables AI assistants to read and edit projects, tasks, client requests, comments, and settings over the Model Context Protocol, deployed with the app and authenticated via read-only or read-write bearer tokens scoped to the creating user.
Updated a month ago (2026-10-07 11:31 UTC)
64 npm
MIT

Appeared in Searches

Search results for 'Clarik'

Clerk MCP Server

Getting Your Clerk API Key

Two Operating Modes

Hosted Mode (Private)

Public Mode (Per-Request Key)

Quick Start

1. Clone & install

2. Configure & run

3. Verify

Connect to AI Assistants

Claude Code (CLI)

Claude Desktop

Cursor

VS Code (GitHub Copilot)

Windsurf

Docker

Build the image

Run in hosted mode

Run in public mode

Docker Compose

Available Tools

Organizations

Members

Invitations

Users

Example Prompts

Deploying to Production

Adding New Tools

Tech Stack

License

Tool Schema Changelog

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Fireblocks MCP Serverofficial

Bitwarden MCP Serverofficial

posthog-mcp-server

Seeder MCP Server

Appeared in Searches