Set up Convex MCP in VS Code
Introspect tables, call functions, read and write data, manage environment variables, and view logs on your Convex reactive backend.
1
Locate the config file
VS Code reads MCP server configuration from the following file:
.vscode/settings.json → mcp sectionCreate this file if it does not already exist. For VS Code, this is inside your workspace .vscode/settings.json file under the mcp section.
2
Add the configuration
Add the following to your VS Code config file:
json
{
"servers": {
"convex-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"convex@latest",
"mcp",
"start"
]
}
}
}3
Set up environment variables
No environment variables needed. Convex MCP works out of the box without any API keys or tokens.
4
Verify it works
Restart VS Code. 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.