MongoDB

by MongoDB

v1.14.0

Apache-2.0

Repository Docs npm

Featured Databases & Data

databasenosqlmongodbatlas

Summary

MongoDB's official MCP server — query databases, explore schemas, and manage Atlas clusters from an AI client.

Features

Query collections and inspect schemas in natural language
Manage Atlas clusters, users, and network access
Read-only mode and per-tool allow lists

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

Open your agent's MCP configuration file.
Merge the snippet below into it, filling in the environment variables with your own values.
Restart the agent — the "MongoDB" tools will be available.

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server"
      ],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "mongodb://localhost:27017"
      }
    }
  }
}

Claude Code

Add the server with a single CLI command.

claude mcp add mongodb -e MDB_MCP_CONNECTION_STRING=mongodb://localhost:27017 -- npx -y mongodb-mcp-server

Claude Desktop

Add the server to claude_desktop_config.json (Settings → Developer → Edit Config).

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server"
      ],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "mongodb://localhost:27017"
      }
    }
  }
}

Cursor

{
  "command": "npx",
  "args": [
    "-y",
    "mongodb-mcp-server"
  ],
  "env": {
    "MDB_MCP_CONNECTION_STRING": "mongodb://localhost:27017"
  }
}

Windsurf

{
  "command": "npx",
  "args": [
    "-y",
    "mongodb-mcp-server"
  ],
  "env": {
    "MDB_MCP_CONNECTION_STRING": "mongodb://localhost:27017"
  }
}

VS Code

{
  "command": "npx",
  "args": [
    "-y",
    "mongodb-mcp-server"
  ],
  "env": {
    "MDB_MCP_CONNECTION_STRING": "mongodb://localhost:27017"
  }
}

Description

The official MongoDB MCP server connects an AI assistant to both MongoDB deployments and Atlas control-plane operations.

What it exposes

Data operations. Find, aggregate, count, insert, update, and delete documents, with the assistant able to inspect collection schemas first rather than guessing field names.
Schema exploration. List databases and collections, sample documents, and describe indexes — which is what makes the assistant's queries correct instead of plausible.
Atlas management. Create and inspect clusters, manage database users, and configure network access, for teams that operate on Atlas.
Index advice based on the queries you are actually running.

Safety

The server supports a read-only mode and per-tool allow lists, which is worth configuring before pointing it at anything that matters. Connection details are supplied through environment variables rather than the model's context.

Getting started

Runs through npx with a connection string in MDB_MCP_CONNECTION_STRING, or with Atlas API credentials for control-plane access. Works with Claude Desktop, Claude Code, Cursor, VS Code, and any MCP-compatible client.