mongodb-mcp-server

Name: mongodb-mcp-server
Author: mongodb-js

Community

MCP server by mongodb-js · updated 3 days ago · ★ 1.1k · 84k downloads a week

Score 91

MongoDB Model Context Protocol Server mongodb-mcp-server is a community project by mongodb-js, not verified by a company domain.

Install Add to Cursor Add to VS Code GitHub

Yours? Claim it

Works withClaude Code Claude Desktop Cursor Codex Gemini CLI VS Code Windsurf Antigravity CLI

Maintenance

Last commit 3 days ago

Licence

Apache-2.0: permissive, fine for commercial use

Quality

Published package or server URL, 1,146 stars, original repository

Security

Not checked yet. What we check

What you need

Setting	Needed	What it is
`MDB_MCP_ALLOW_REQUEST_OVERRIDES`Environment variable	Optional	When set to true, allows configuration values to be overridden via request headers and query parameters.
`MDB_MCP_API_CLIENT_ID`Environment variable, secret	Optional	Atlas API client ID for authentication. Required for running Atlas tools.
`MDB_MCP_API_CLIENT_SECRET`Environment variable, secret	Optional	Atlas API client secret for authentication. Required for running Atlas tools.
`MDB_MCP_ASSISTANT_BASE_URL`Environment variable	Optional	Base URL for the MongoDB Assistant API.
`MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS`Environment variable	Optional	Time in milliseconds that temporary database users created when connecting to MongoDB Atlas clusters will remain active before being automatically deleted.
`MDB_MCP_CONFIRMATION_REQUIRED_TOOLS`Environment variable	Optional	Comma separated values of tool names that require user confirmation before execution. Requires the client to support elicitation.
`MDB_MCP_CONNECTION_SCOPE`Environment variable	Optional	Visibility scope for MongoDB connections created at runtime. With 'session' (the default), each MCP session only sees the connections it created (plus the shared 'preconfigured' one) and they are closed when the session ends — recommended w
`MDB_MCP_CONNECTION_STRING`Environment variable, secret	Optional	MongoDB connection string for direct database connections. Optional, if not set, you'll need to call the connect tool before interacting with MongoDB data.
`MDB_MCP_DISABLE_SERVER_SIDE_JS`Environment variable	Optional	When set to true, disallows the use of server-side JavaScript operators (such as $where, $function, and $accumulator) in query filters and aggregation pipelines.
`MDB_MCP_DISABLED_TOOLS`Environment variable	Optional	Comma separated values of tool names, operation types, and/or categories of tools that will be disabled.
`MDB_MCP_DRY_RUN`Environment variable	Optional	When true, runs the server in dry mode: dumps configuration and enabled tools, then exits without starting the server.
`MDB_MCP_ELICITATION_TIMEOUT_MS`Environment variable	Optional	Time in milliseconds the user has to respond to an elicitation request (such as a tool confirmation prompt) before it fails.
`MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS`Environment variable	Optional	Time in milliseconds between export cleanup cycles that remove expired export files.
`MDB_MCP_EXPORT_TIMEOUT_MS`Environment variable	Optional	Time in milliseconds after which an export is considered expired and eligible for cleanup.
`MDB_MCP_EXPORTS_PATH`Environment variable	Optional	Folder to store exported data files.
`MDB_MCP_EXTERNALLY_MANAGED_SESSIONS`Environment variable	Optional	When true, the HTTP transport allows requests with a session ID supplied externally through the 'mcp-session-id' header. When an external ID is supplied, the initialization request is optional.
`MDB_MCP_HEALTH_CHECK_HOST`Environment variable	Optional	Deprecated. Use `monitoringServerHost` instead. Host address to bind the healthCheck HTTP server to (only used when transport is 'http'). If provided, `healthCheckPort` must also be set.
`MDB_MCP_HEALTH_CHECK_PORT`Environment variable	Optional	Deprecated. Use `monitoringServerPort` instead. Port number for the healthCheck HTTP server (only used when transport is 'http'). If provided, `healthCheckHost` must also be set.
`MDB_MCP_HTTP_BODY_LIMIT`Environment variable	Optional	Maximum size of the HTTP request body in bytes (only used when transport is 'http'). This value is passed as the optional limit parameter to the Express.js json() middleware.
`MDB_MCP_HTTP_HEADERS`Environment variable	Optional	Header that the HTTP server will validate when making requests (only used when transport is 'http').

From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.

Install mongodb-mcp-server

Built from the published package, never by AI

claude mcp add mongodb-mcp-server -- npx -y mongodb-mcp-server

Run in your terminal. Add --scope user to use it in every project.

Step-by-step: install mongodb-mcp-server in Claude Code

{
  "mcpServers": {
    "mongodb-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server"
      ]
    }
  }
}

Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.

Step-by-step: install mongodb-mcp-server in Claude Desktop

{
  "mcpServers": {
    "mongodb-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).

Step-by-step: install mongodb-mcp-server in Cursor

{
  "servers": {
    "mongodb-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server"
      ]
    }
  }
}

Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".

Step-by-step: install mongodb-mcp-server in VS Code

codex mcp add mongodb-mcp-server -- npx -y mongodb-mcp-server

Step-by-step: install mongodb-mcp-server in Codex

{
  "mcpServers": {
    "mongodb-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server"
      ]
    }
  }
}

Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).

Step-by-step: install mongodb-mcp-server in Antigravity CLI

gemini mcp add mongodb-mcp-server npx -y mongodb-mcp-server

Gemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.

Step-by-step: install mongodb-mcp-server in Gemini CLI

MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the mongodb-mcp-server block.

Weekly newsletter

Like mongodb-mcp-server? Get the best new MCP servers every week

The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.

Alternatives to mongodb-mcp-server

All alternatives →

Supabase supabase

MCP server for interacting with the Supabase platform

AAB Local and remote 65k/wk

ArcadeDB MCP Server ArcadeData

Built-in MCP server for ArcadeDB multi-model database (graph, document, vector, time-series)

AAA Local 1.2k

MCP Toolbox for Databasesgoogleapis

MCP Toolbox for Databases enables your agent to connect to your database.

AAA Local 17k

MCP Toolbox for Databasesgoogleapis

MCP Toolbox for Databases enables your agent to connect to your database.

AAA Local 17k

mcpkubeshark

Real-time Kubernetes network traffic visibility and API analysis for HTTP, gRPC, Redis, Kafka, DNS.

AAA Local 12k

Ruvector ruvnet

Self-learning vector database for Node.js — hybrid search, Graph RAG, FlashAttention-3, HNSW, 50+ attention mechanisms

AAA Local 72k/wk

mongodb-mcp-server vs Supabase mongodb-mcp-server vs ArcadeDB MCP Server mongodb-mcp-server vs MCP Toolbox for Databases

mongodb-mcp-server: common questions

How do I install mongodb-mcp-server?

In Claude Code run claude mcp add mongodb-mcp-server -- npx -y mongodb-mcp-server. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.

Is mongodb-mcp-server the official server?

mongodb-mcp-server is a community project by mongodb-js, not verified by a company domain.

Is mongodb-mcp-server free?

The code is published under the Apache-2.0 licence. The service it connects to may have its own pricing.

Is mongodb-mcp-server safe to use?

It scores 91 of 100. Grades: maintenance A, licence A, quality B. The security check has not run for it yet. Review the code before you install. How grades work.

What are alternatives to mongodb-mcp-server?

Does mongodb-mcp-server work with ChatGPT?

Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.