Convex MCP Server

Auth-aware Convex component that exposes selected Convex functions as MCP tools.

Local serverstdio

What is the Convex MCP Server?

Auth-aware Convex component that exposes selected Convex functions as MCP tools.

What you get

Auth-aware MCP server for Convex. Expose selected Convex functions as MCP tools, bring your own JWT issuer, declare scopes/roles per tool, get an audit log and OAuth 2.1 protected-resource discovery for free.

  • Type-safe tool registration — defineMcpQuery / defineMcpMutation /
  • MCP 2025-06-18 Streamable HTTP — sessions, Accept negotiation,
  • MCP resources — defineMcpResource / defineMcpResourceTemplate
  • One authorize callback — gates tools/call and filters tools/list
  • OAuth 2.1 protected-resource discovery — RFC 9728 metadata,
  • Optional OAuth bridge — RFC 8414 AS metadata wrap + RFC 7591 DCR

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Convex MCP Server

{
  "mcpServers": {
    "convex-1": {
      "command": "npx",
      "args": ["-y", "convex"],
      "env": {
        "CONVEX_SITE_URL": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
CONVEX_SITE_URLEndpoint or connection string the server talks to.Yes

Frequently asked questions

Auth-aware Convex component that exposes selected Convex functions as MCP tools. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.