Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Databases - official Convex server

Convex MCP server

Local MCP server built into the Convex CLI that lets agents inspect and act on a Convex deployment: list tables and schemas, page through data, run read-only one-off queries, call deployed functions, read logs and health insights, and manage environment variables. It runs locally from convex (npm); the notes below cover how it authenticates.

Last verified 12 tools8 sources

Install

Claude Code

About Claude Code
Snippet
/plugin install convex@claude-plugins-official

Codex

About Codex
TOML
[mcp_servers.convex]
command = "npx"
args = ["-y", "convex@latest", "mcp", "start"]

Cursor

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

VS Code

JSON
{
  "servers": {
    "convex-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "convex@latest", "mcp", "start"]
    }
  }
}

Generic

Terminal
npx -y convex@latest mcp start

Tools

status
Queries available deployments and returns a deployment selector for other tools
tables
Lists all tables with declared and inferred schemas and metadata
data
Paginates through documents in a specified table
runOneoffQuery
Runs sandboxed read-only JavaScript queries against deployment data
functionSpec
Metadata about all deployed functions: types, visibility, interfaces
run
Executes deployed Convex functions with provided arguments
logs
Fetches recent function execution log entries as structured objects
insights
Health insights for the last 72 hours, including OCC conflicts and resource limit issues
envList
Lists environment variable names, optionally with values
envGet
Retrieves the value of a specific environment variable
envSet
Sets a new environment variable or updates an existing one
envRemove
Removes an environment variable from the deployment

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • Uses the credentials from npx convex login (access to all projects on the account) unless CONVEX_DEPLOY_KEY is set to restrict it to one deployment; the insights tool is unavailable with a deploy key.
  • Production access is limited to non-PII read-only tools by default; --cautiously-allow-production-pii and --dangerously-enable-production-deployments widen it, and --disable-tools removes tools.
  • The Claude Code snippet installs the official Convex plugin, which starts the MCP server automatically (Convex recommends the plugin for Claude Code and Cursor).
  • The docs page carries no beta/GA label.

More MCP servers for databases

Related reading

FAQ

What does the Convex MCP server do?

Local MCP server built into the Convex CLI that lets agents inspect and act on a Convex deployment: list tables and schemas, page through data, run read-only one-off queries, call deployed functions, read logs and health insights, and manage environment variables. The vendor documents 12 tools, including status, tables, data and runOneoffQuery.

How do I add the Convex MCP server to Claude Code?

Run /plugin install convex@claude-plugins-official, copied from Convex's docs. This page also has snippets for Codex, Cursor, VS Code and Generic.

Does the Convex MCP server need authentication?

It uses a scheme other than OAuth or an API key, such as the session of the app or instance it runs in; the notes on this page describe it. Transport: stdio. Status: Unlabelled, last checked October 17, 2026.

Sources

Last verified against 8 Convex pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.