Set up Convex MCP in Windsurf

Introspect tables, call functions, read and write data, manage environment variables, and view logs on your Convex reactive backend.

Locate the config file

Windsurf reads MCP server configuration from the following file:

~/.codeium/windsurf/mcp_config.json

Create this file if it does not already exist.

Add the configuration

Add the following to your Windsurf config file:

json

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

Set up environment variables

No environment variables needed. Convex MCP works out of the box without any API keys or tokens.

Verify it works

Restart Windsurf. Convex MCP should appear in your MCP server list with 12 tools available.

This server adds approximately 6,180 tokens to your context window for tool definitions.

Set up Convex MCP in other editors

Claude Code Cursor VS Code Claude Desktop Continue

← Back to Convex MCP