MongoDB MCP Server

Add to your client

Copy the config for your MCP client and paste it into its config file.

{
  "mcpServers": {
    "mongodb-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server@latest",
        "--readOnly"
      ],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "mongodb+srv://<user>:<password>@<cluster-host>/<db>"
      }
    }
  }
}

Before you start

• Node.js v22.13.0 or later (Node 20.x support is deprecated)
• A MongoDB connection string for the deployment you want to access (Atlas, Community, or Enterprise), OR Atlas API Service Account credentials (Client ID + Secret) for Atlas control-plane tools
• For Atlas tools: an Atlas Service Account created in the Atlas UI under Access Manager, with the minimum required project/org roles
• Optionally Docker, if you prefer running the published container image instead of npx

About MongoDB MCP Server

Tools & capabilities (15)

When to use it

• Use it when you want an AI agent to explore an unfamiliar MongoDB database — listing collections, inferring schemas, and counting documents — without writing queries by hand
• Use it when you need to run ad-hoc finds and aggregations in natural language during debugging or analysis
• Use it when provisioning or managing Atlas resources (clusters, projects, DB users, IP access lists) from your AI tooling instead of the Atlas UI
• Use it when you want index and query-plan advice — inspecting indexes, running explain, and checking the performance advisor
• Use it when you want a read-only, guard-railed connection so an assistant can inspect production data safely

Quick setup

1. 1Choose your credential: a MongoDB connection string (set MDB_MCP_CONNECTION_STRING), or Atlas Service Account Client ID + Secret for Atlas tools
2. 2Add the server to your MCP client config using npx (command: npx, args: -y mongodb-mcp-server) or the Docker image
3. 3Pass the connection string / Atlas credentials via environment variables or CLI args
4. 4Optionally set --readOnly and document/byte limits to constrain agent behavior
5. 5Restart your MCP client and confirm the mongodb tools appear, then run list-databases to verify the connection

MongoDB MCP Server FAQ