Convex MCP Server: Install Guide and Examples (2026)

Name: Convex MCP Server
Author: convex

How to install the Convex MCP server

Add this to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "convex": {
      "command": "npx",
      "args": [
        "-y",
        "convex@latest",
        "mcp",
        "start"
      ]
    }
  }
}

Add this to your Claude Code MCP configuration:

npx -y convex@latest mcp start

Add this to your Cursor MCP configuration:

{
  "mcpServers": {
    "convex": {
      "command": "npx",
      "args": [
        "-y",
        "convex@latest",
        "mcp",
        "start"
      ]
    }
  }
}

Add this to your Windsurf MCP configuration:

{
  "mcpServers": {
    "convex": {
      "command": "npx",
      "args": [
        "-y",
        "convex@latest",
        "mcp",
        "start"
      ]
    }
  }
}

Built by ContextBoltThis directory is built by ContextBolt: MCP-native memory and SEO tools that run alongside Convex in the same client.

Explore ContextBolt

Convex ships an official MCP server inside its CLI, so an agent can look at your actual backend instead of guessing at your schema. If you build on Convex, this is the fastest way to let Claude or Cursor reason about your real tables, functions, and data.

Why use it

Most coding help is generic because the model cannot see your deployment. This server closes that gap. The agent can list your tables, read function signatures, and run queries against a live deployment, which makes debugging and feature work far more grounded.

What it actually does

Start it with npx -y convex@latest mcp start and point your client at it. From there the agent can introspect tables and functions, run read queries, and read or write data in a deployment you choose. Useful prompts:

‘List every table in my dev deployment and show the schema for messages.’
‘Run a query that returns the 10 most recent users.’
‘Which functions write to the projects table?‘

Gotchas

Writes are possible, so be deliberate about which deployment you connect. On production the server defaults to read-only and redacts PII, which is safe, but it also means some data will not be visible. Point it at dev or a preview deployment when you actually need to change records. It only helps if your project is already on Convex.

Built by ContextBolt

This directory is built by ContextBolt

We build MCP-native tools that give your AI the context it cannot reach on its own. Bookmarks turns your saved posts into agent-queryable memory. SEO puts live keyword and ranking data inside Claude. Both run alongside Convex in the same client.

Explore the products →