Overview
MongoDB MCP Server is a Model Context Protocol server that provides read-only access to MongoDB databases, enabling LLMs to inspect collection schemas and execute aggregation pipelines.
To use the MongoDB MCP Server, configure it in the Claude Desktop app by adding the necessary command and environment variables in the claude_desktop_config.json file, replacing placeholders with your database details.
- Execute MongoDB aggregation pipelines with customizable options. - Retrieve execution plans for aggregation pipelines. - Access inferred JSON schema information for each collection. - Automatic safety features like document limits and timeouts.
- Analyzing user demographics from a collection of user data.
- Generating statistics for data visualization.
- Performing complex queries without modifying the database.
Add to your AI client
Use these steps to connect MongoDB MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mongodb-developer-mongodb-mcp-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mongodb-developer-mongodb-mcp-server-mcp-mirror"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mongodb-developer-mongodb-mcp-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mongodb-developer-mongodb-mcp-server-mcp-mirror"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mongodb-developer-mongodb-mcp-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mongodb-developer-mongodb-mcp-server-mcp-mirror"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mongodb-developer-mongodb-mcp-server-mcp-mirror": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mongodb-developer-mongodb-mcp-server-mcp-mirror"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mongodb-developer-mongodb-mcp-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mongodb-developer-mongodb-mcp-server-mcp-mirror"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mongodb-developer-mongodb-mcp-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mongodb-developer-mongodb-mcp-server-mcp-mirror"
]
}
}
}FAQ
Is MongoDB MCP Server free to use?
Yes! It is licensed under the MIT License, allowing free use and modification.
What kind of operations can I perform?
You can perform read-only operations, including aggregation and schema inspection.
Are there any limits on the queries?
Yes, there is a default limit of 1000 documents and a timeout of 30 seconds for operations.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":608,"uuid":"513fae58-67da-4b40-b630-8bbfabfa3320","name":"mongodb-developer_mongodb-mcp-server","title":"MongoDB MCP Server","description":"Mirror of","avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","created_at":"2024-12-30T03:24:10.218Z","updated_at":"2025-02-23T07:15:12.497Z","status":"created","author_name":"MCP-Mirror","author_avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","tags":"mongodb,mcp-server,database-access","category":"research-and-data","is_featured":false,"sort":1,"url":"https://github.com/MCP-Mirror/mongodb-developer_mongodb-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]