Prototype · This site is a prototype showing 100 real servers from the official registry, not all of them yet.
PopNx MCPMCP servers for people who use AI · explained in plain words

MongoDB MCP Server

by mongodb-jsversion 3.2.2i★ 1,157iRuns on your computer
Registry nameio.github.mongodb-js/mongodb-mcp-server

Overview

Description from the maker (original English)

MongoDB Model Context Protocol Server

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

  • Connection: Runs on your computer
  • Transport: stdio
  • Category: Databases & datasets
  • You need to fill in: MDB_MCP_API_CLIENT_ID, MDB_MCP_API_CLIENT_SECRET, MDB_MCP_CONNECTION_STRING, MDB_MCP_CONNECTION_STRINGS, MDB_MCP_VOYAGE_API_KEY

Install

Pick the AI app you use, then copy the settings.

You need

  • npmNode.js installed (for the npx command)

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server"
      ],
      "env": {
        "MDB_MCP_AGGREGATION_COUNT_MAX_TIME_MS_CAP": "your-value",
        "MDB_MCP_AGGREGATION_COUNT_TIMEOUT_MS": "your-value",
        "MDB_MCP_ALLOW_REQUEST_OVERRIDES": "your-value",
        "MDB_MCP_API_CLIENT_ID": "your-value",
        "MDB_MCP_API_CLIENT_SECRET": "your-value",
        "MDB_MCP_ASSISTANT_BASE_URL": "your-value",
        "MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS": "your-value",
        "MDB_MCP_CONFIRMATION_REQUIRED_TOOLS": "your-value",
        "MDB_MCP_CONNECTION_IDLE_TIMEOUT_MS": "your-value",
        "MDB_MCP_CONNECTION_SCOPE": "your-value",
        "MDB_MCP_CONNECTION_STRING": "your-value",
        "MDB_MCP_CONNECTION_STRINGS": "your-value",
        "MDB_MCP_DANGEROUS_HOST_BINDING": "your-value",
        "MDB_MCP_DISABLE_SERVER_SIDE_JS": "your-value",
        "MDB_MCP_DISABLE_UNTRUSTED_DATA_WARNING": "your-value",
        "MDB_MCP_DISABLED_TOOLS": "your-value",
        "MDB_MCP_DRY_RUN": "your-value",
        "MDB_MCP_ELICITATION_TIMEOUT_MS": "your-value",
        "MDB_MCP_EVICTION_IDLE_GRACE_M_S": "your-value",
        "MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS": "your-value",
        "MDB_MCP_EXPORT_TIMEOUT_MS": "your-value",
        "MDB_MCP_EXPORTS_PATH": "your-value",
        "MDB_MCP_EXTERNALLY_MANAGED_SESSIONS": "your-value",
        "MDB_MCP_HEALTH_CHECK_HOST": "your-value",
        "MDB_MCP_HEALTH_CHECK_PORT": "your-value",
        "MDB_MCP_HTTP_BODY_LIMIT": "your-value",
        "MDB_MCP_HTTP_HEADERS": "your-value",
        "MDB_MCP_HTTP_HOST": "your-value",
        "MDB_MCP_HTTP_PORT": "your-value",
        "MDB_MCP_HTTP_RESPONSE_TYPE": "your-value",
        "MDB_MCP_IDLE_TIMEOUT_MS": "your-value",
        "MDB_MCP_INDEX_CHECK": "your-value",
        "MDB_MCP_LOG_PATH": "your-value",
        "MDB_MCP_LOGGERS": "your-value",
        "MDB_MCP_MAX_ACTIVE_CONNECTIONS": "your-value",
        "MDB_MCP_MAX_BYTES_PER_QUERY": "your-value",
        "MDB_MCP_MAX_DOCUMENTS_PER_QUERY": "your-value",
        "MDB_MCP_MAX_SESSIONS": "your-value",
        "MDB_MCP_MAX_TIME_M_S": "your-value",
        "MDB_MCP_MCP_CLIENT_LOG_LEVEL": "your-value",
        "MDB_MCP_MONITORING_SERVER_FEATURES": "your-value",
        "MDB_MCP_MONITORING_SERVER_HOST": "your-value",
        "MDB_MCP_MONITORING_SERVER_PORT": "your-value",
        "MDB_MCP_NOTIFICATION_TIMEOUT_MS": "your-value",
        "MDB_MCP_PREVIEW_FEATURES": "your-value",
        "MDB_MCP_QUERY_COUNT_MAX_TIME_MS_CAP": "your-value",
        "MDB_MCP_QUERY_COUNT_TIMEOUT_MS": "your-value",
        "MDB_MCP_READ_ONLY": "your-value",
        "MDB_MCP_TELEMETRY": "your-value",
        "MDB_MCP_TIMEOUT_MS": "your-value",
        "MDB_MCP_TRANSPORT": "your-value",
        "MDB_MCP_VOYAGE_API_KEY": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add mongodb --env MDB_MCP_AGGREGATION_COUNT_MAX_TIME_MS_CAP=your-value --env MDB_MCP_AGGREGATION_COUNT_TIMEOUT_MS=your-value --env MDB_MCP_ALLOW_REQUEST_OVERRIDES=your-value --env MDB_MCP_API_CLIENT_ID=your-value --env MDB_MCP_API_CLIENT_SECRET=your-value --env MDB_MCP_ASSISTANT_BASE_URL=your-value --env MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS=your-value --env MDB_MCP_CONFIRMATION_REQUIRED_TOOLS=your-value --env MDB_MCP_CONNECTION_IDLE_TIMEOUT_MS=your-value --env MDB_MCP_CONNECTION_SCOPE=your-value --env MDB_MCP_CONNECTION_STRING=your-value --env MDB_MCP_CONNECTION_STRINGS=your-value --env MDB_MCP_DANGEROUS_HOST_BINDING=your-value --env MDB_MCP_DISABLE_SERVER_SIDE_JS=your-value --env MDB_MCP_DISABLE_UNTRUSTED_DATA_WARNING=your-value --env MDB_MCP_DISABLED_TOOLS=your-value --env MDB_MCP_DRY_RUN=your-value --env MDB_MCP_ELICITATION_TIMEOUT_MS=your-value --env MDB_MCP_EVICTION_IDLE_GRACE_M_S=your-value --env MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS=your-value --env MDB_MCP_EXPORT_TIMEOUT_MS=your-value --env MDB_MCP_EXPORTS_PATH=your-value --env MDB_MCP_EXTERNALLY_MANAGED_SESSIONS=your-value --env MDB_MCP_HEALTH_CHECK_HOST=your-value --env MDB_MCP_HEALTH_CHECK_PORT=your-value --env MDB_MCP_HTTP_BODY_LIMIT=your-value --env MDB_MCP_HTTP_HEADERS=your-value --env MDB_MCP_HTTP_HOST=your-value --env MDB_MCP_HTTP_PORT=your-value --env MDB_MCP_HTTP_RESPONSE_TYPE=your-value --env MDB_MCP_IDLE_TIMEOUT_MS=your-value --env MDB_MCP_INDEX_CHECK=your-value --env MDB_MCP_LOG_PATH=your-value --env MDB_MCP_LOGGERS=your-value --env MDB_MCP_MAX_ACTIVE_CONNECTIONS=your-value --env MDB_MCP_MAX_BYTES_PER_QUERY=your-value --env MDB_MCP_MAX_DOCUMENTS_PER_QUERY=your-value --env MDB_MCP_MAX_SESSIONS=your-value --env MDB_MCP_MAX_TIME_M_S=your-value --env MDB_MCP_MCP_CLIENT_LOG_LEVEL=your-value --env MDB_MCP_MONITORING_SERVER_FEATURES=your-value --env MDB_MCP_MONITORING_SERVER_HOST=your-value --env MDB_MCP_MONITORING_SERVER_PORT=your-value --env MDB_MCP_NOTIFICATION_TIMEOUT_MS=your-value --env MDB_MCP_PREVIEW_FEATURES=your-value --env MDB_MCP_QUERY_COUNT_MAX_TIME_MS_CAP=your-value --env MDB_MCP_QUERY_COUNT_TIMEOUT_MS=your-value --env MDB_MCP_READ_ONLY=your-value --env MDB_MCP_TELEMETRY=your-value --env MDB_MCP_TIMEOUT_MS=your-value --env MDB_MCP_TRANSPORT=your-value --env MDB_MCP_VOYAGE_API_KEY=your-value -- npx -y mongodb-mcp-server

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server"
      ],
      "env": {
        "MDB_MCP_AGGREGATION_COUNT_MAX_TIME_MS_CAP": "your-value",
        "MDB_MCP_AGGREGATION_COUNT_TIMEOUT_MS": "your-value",
        "MDB_MCP_ALLOW_REQUEST_OVERRIDES": "your-value",
        "MDB_MCP_API_CLIENT_ID": "your-value",
        "MDB_MCP_API_CLIENT_SECRET": "your-value",
        "MDB_MCP_ASSISTANT_BASE_URL": "your-value",
        "MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS": "your-value",
        "MDB_MCP_CONFIRMATION_REQUIRED_TOOLS": "your-value",
        "MDB_MCP_CONNECTION_IDLE_TIMEOUT_MS": "your-value",
        "MDB_MCP_CONNECTION_SCOPE": "your-value",
        "MDB_MCP_CONNECTION_STRING": "your-value",
        "MDB_MCP_CONNECTION_STRINGS": "your-value",
        "MDB_MCP_DANGEROUS_HOST_BINDING": "your-value",
        "MDB_MCP_DISABLE_SERVER_SIDE_JS": "your-value",
        "MDB_MCP_DISABLE_UNTRUSTED_DATA_WARNING": "your-value",
        "MDB_MCP_DISABLED_TOOLS": "your-value",
        "MDB_MCP_DRY_RUN": "your-value",
        "MDB_MCP_ELICITATION_TIMEOUT_MS": "your-value",
        "MDB_MCP_EVICTION_IDLE_GRACE_M_S": "your-value",
        "MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS": "your-value",
        "MDB_MCP_EXPORT_TIMEOUT_MS": "your-value",
        "MDB_MCP_EXPORTS_PATH": "your-value",
        "MDB_MCP_EXTERNALLY_MANAGED_SESSIONS": "your-value",
        "MDB_MCP_HEALTH_CHECK_HOST": "your-value",
        "MDB_MCP_HEALTH_CHECK_PORT": "your-value",
        "MDB_MCP_HTTP_BODY_LIMIT": "your-value",
        "MDB_MCP_HTTP_HEADERS": "your-value",
        "MDB_MCP_HTTP_HOST": "your-value",
        "MDB_MCP_HTTP_PORT": "your-value",
        "MDB_MCP_HTTP_RESPONSE_TYPE": "your-value",
        "MDB_MCP_IDLE_TIMEOUT_MS": "your-value",
        "MDB_MCP_INDEX_CHECK": "your-value",
        "MDB_MCP_LOG_PATH": "your-value",
        "MDB_MCP_LOGGERS": "your-value",
        "MDB_MCP_MAX_ACTIVE_CONNECTIONS": "your-value",
        "MDB_MCP_MAX_BYTES_PER_QUERY": "your-value",
        "MDB_MCP_MAX_DOCUMENTS_PER_QUERY": "your-value",
        "MDB_MCP_MAX_SESSIONS": "your-value",
        "MDB_MCP_MAX_TIME_M_S": "your-value",
        "MDB_MCP_MCP_CLIENT_LOG_LEVEL": "your-value",
        "MDB_MCP_MONITORING_SERVER_FEATURES": "your-value",
        "MDB_MCP_MONITORING_SERVER_HOST": "your-value",
        "MDB_MCP_MONITORING_SERVER_PORT": "your-value",
        "MDB_MCP_NOTIFICATION_TIMEOUT_MS": "your-value",
        "MDB_MCP_PREVIEW_FEATURES": "your-value",
        "MDB_MCP_QUERY_COUNT_MAX_TIME_MS_CAP": "your-value",
        "MDB_MCP_QUERY_COUNT_TIMEOUT_MS": "your-value",
        "MDB_MCP_READ_ONLY": "your-value",
        "MDB_MCP_TELEMETRY": "your-value",
        "MDB_MCP_TIMEOUT_MS": "your-value",
        "MDB_MCP_TRANSPORT": "your-value",
        "MDB_MCP_VOYAGE_API_KEY": "your-value"
      }
    }
  }
}

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "mongodb": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server"
      ],
      "env": {
        "MDB_MCP_AGGREGATION_COUNT_MAX_TIME_MS_CAP": "your-value",
        "MDB_MCP_AGGREGATION_COUNT_TIMEOUT_MS": "your-value",
        "MDB_MCP_ALLOW_REQUEST_OVERRIDES": "your-value",
        "MDB_MCP_API_CLIENT_ID": "your-value",
        "MDB_MCP_API_CLIENT_SECRET": "your-value",
        "MDB_MCP_ASSISTANT_BASE_URL": "your-value",
        "MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS": "your-value",
        "MDB_MCP_CONFIRMATION_REQUIRED_TOOLS": "your-value",
        "MDB_MCP_CONNECTION_IDLE_TIMEOUT_MS": "your-value",
        "MDB_MCP_CONNECTION_SCOPE": "your-value",
        "MDB_MCP_CONNECTION_STRING": "your-value",
        "MDB_MCP_CONNECTION_STRINGS": "your-value",
        "MDB_MCP_DANGEROUS_HOST_BINDING": "your-value",
        "MDB_MCP_DISABLE_SERVER_SIDE_JS": "your-value",
        "MDB_MCP_DISABLE_UNTRUSTED_DATA_WARNING": "your-value",
        "MDB_MCP_DISABLED_TOOLS": "your-value",
        "MDB_MCP_DRY_RUN": "your-value",
        "MDB_MCP_ELICITATION_TIMEOUT_MS": "your-value",
        "MDB_MCP_EVICTION_IDLE_GRACE_M_S": "your-value",
        "MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS": "your-value",
        "MDB_MCP_EXPORT_TIMEOUT_MS": "your-value",
        "MDB_MCP_EXPORTS_PATH": "your-value",
        "MDB_MCP_EXTERNALLY_MANAGED_SESSIONS": "your-value",
        "MDB_MCP_HEALTH_CHECK_HOST": "your-value",
        "MDB_MCP_HEALTH_CHECK_PORT": "your-value",
        "MDB_MCP_HTTP_BODY_LIMIT": "your-value",
        "MDB_MCP_HTTP_HEADERS": "your-value",
        "MDB_MCP_HTTP_HOST": "your-value",
        "MDB_MCP_HTTP_PORT": "your-value",
        "MDB_MCP_HTTP_RESPONSE_TYPE": "your-value",
        "MDB_MCP_IDLE_TIMEOUT_MS": "your-value",
        "MDB_MCP_INDEX_CHECK": "your-value",
        "MDB_MCP_LOG_PATH": "your-value",
        "MDB_MCP_LOGGERS": "your-value",
        "MDB_MCP_MAX_ACTIVE_CONNECTIONS": "your-value",
        "MDB_MCP_MAX_BYTES_PER_QUERY": "your-value",
        "MDB_MCP_MAX_DOCUMENTS_PER_QUERY": "your-value",
        "MDB_MCP_MAX_SESSIONS": "your-value",
        "MDB_MCP_MAX_TIME_M_S": "your-value",
        "MDB_MCP_MCP_CLIENT_LOG_LEVEL": "your-value",
        "MDB_MCP_MONITORING_SERVER_FEATURES": "your-value",
        "MDB_MCP_MONITORING_SERVER_HOST": "your-value",
        "MDB_MCP_MONITORING_SERVER_PORT": "your-value",
        "MDB_MCP_NOTIFICATION_TIMEOUT_MS": "your-value",
        "MDB_MCP_PREVIEW_FEATURES": "your-value",
        "MDB_MCP_QUERY_COUNT_MAX_TIME_MS_CAP": "your-value",
        "MDB_MCP_QUERY_COUNT_TIMEOUT_MS": "your-value",
        "MDB_MCP_READ_ONLY": "your-value",
        "MDB_MCP_TELEMETRY": "your-value",
        "MDB_MCP_TIMEOUT_MS": "your-value",
        "MDB_MCP_TRANSPORT": "your-value",
        "MDB_MCP_VOYAGE_API_KEY": "your-value"
      }
    }
  }
}

Values you fill in

  • MDB_MCP_AGGREGATION_COUNT_MAX_TIME_MS_CAP env
    Deprecated. Use `aggregationCountTimeoutMs` instead.
  • MDB_MCP_AGGREGATION_COUNT_TIMEOUT_MS env
    The maximum time in milliseconds for the count phase of aggregation operations. This is used to limit the time spent counting documents when determining if results were capped.
  • MDB_MCP_ALLOW_REQUEST_OVERRIDES env
    When set to true, allows configuration values to be overridden via request headers and query parameters.
  • MDB_MCP_API_CLIENT_ID secret env
    Atlas API client ID for authentication. Required for running Atlas tools.
  • MDB_MCP_API_CLIENT_SECRET secret env
    Atlas API client secret for authentication. Required for running Atlas tools.
  • MDB_MCP_ASSISTANT_BASE_URL env
    Base URL for the MongoDB Assistant API.
  • MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS env
    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 env
    Comma separated values of tool names that require user confirmation before execution. Requires the client to support elicitation.
  • MDB_MCP_CONNECTION_IDLE_TIMEOUT_MS env
    Milliseconds a MongoDB connection may stay unused (no tool call touching it) before it is closed to release the underlying connection pool and its server-side state. Applied per connection regardless…
  • MDB_MCP_CONNECTION_SCOPE env
    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 clo…
  • MDB_MCP_CONNECTION_STRING secret env
    MongoDB connection string for direct database connections, exposed under the connectionId "preconfigured". Optional, if not set, you'll need to call the connect tool before interacting with MongoDB d…
  • MDB_MCP_CONNECTION_STRINGS secret env
    MongoDB connection strings keyed by name, as a JSON object (e.g. {"preconfigured": "mongodb://...", "analytics": "mongodb://..."}). Each name becomes a connectionId that the MongoDB tools can use dir…
  • MDB_MCP_DANGEROUS_HOST_BINDING env
    When set to true, allows binding the HTTP server (and monitoring server) to a non-loopback host such as 0.0.0.0, a LAN IP, or an empty host (all interfaces). Binding to a non-loopback host exposes th…
  • MDB_MCP_DISABLE_SERVER_SIDE_JS env
    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_DISABLE_UNTRUSTED_DATA_WARNING env
    When set to true, tool responses include potentially untrusted data (such as documents or query results) as-is, without wrapping it in delimiters and a prompt-injection warning.
  • MDB_MCP_DISABLED_TOOLS env
    Comma separated values of tool names, operation types, and/or categories of tools that will be disabled.
  • MDB_MCP_DRY_RUN env
    When true, runs the server in dry mode: dumps configuration and enabled tools, then exits without starting the server.
  • MDB_MCP_ELICITATION_TIMEOUT_MS env
    Time in milliseconds the user has to respond to an elicitation request (such as a tool confirmation prompt) before it fails.
  • MDB_MCP_EVICTION_IDLE_GRACE_M_S env
    How long a session must be idle before it becomes eligible for least-recently-used eviction when the HTTP transport is at its maxSessions cap (only used when transport is 'http'). Swept back to idleT…
  • MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS env
    Time in milliseconds between export cleanup cycles that remove expired export files.
  • MDB_MCP_EXPORT_TIMEOUT_MS env
    Time in milliseconds after which an export is considered expired and eligible for cleanup.
  • MDB_MCP_EXPORTS_PATH env
    Folder to store exported data files.
  • MDB_MCP_EXTERNALLY_MANAGED_SESSIONS env
    When true, the 2025-era HTTP transport accepts a session ID supplied externally through the 'mcp-session-id' header. When an external ID is supplied, the initialization request is optional, and an im…
  • MDB_MCP_HEALTH_CHECK_HOST env
    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 env
    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 env
    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 env
    Header that the HTTP server will validate when making requests (only used when transport is 'http').
  • MDB_MCP_HTTP_HOST env
    Host address to bind the HTTP server to (only used when transport is 'http').
  • MDB_MCP_HTTP_PORT env
    Port number for the HTTP server (only used when transport is 'http'). Use 0 for a random port.
  • MDB_MCP_HTTP_RESPONSE_TYPE env
    The HTTP response type for tool responses: 'sse' for Server-Sent Events, 'json' for standard JSON responses.
  • MDB_MCP_IDLE_TIMEOUT_MS env
    Idle timeout for a client to disconnect (only applies to http transport).
  • MDB_MCP_INDEX_CHECK env
    When set to true, enforces that query operations must use an index, rejecting queries that perform a collection scan.
  • MDB_MCP_LOG_PATH env
    Folder to store logs.
  • MDB_MCP_LOGGERS env
    Comma separated values of logger types.
  • MDB_MCP_MAX_ACTIVE_CONNECTIONS env
    Maximum number of MongoDB connections a single scope (an MCP session by default, see connectionScope) can hold open. When exceeded, the scope's least-recently-used connection is closed and its connec…
  • MDB_MCP_MAX_BYTES_PER_QUERY env
    The maximum size in bytes for results from a find or aggregate tool call. This serves as an upper bound for the responseBytesLimit parameter in those tools.
  • MDB_MCP_MAX_DOCUMENTS_PER_QUERY env
    The maximum number of documents that can be returned by a find or aggregate tool call. For the find tool, the effective limit will be the smaller of this value and the tool's limit parameter.
  • MDB_MCP_MAX_SESSIONS env
    Maximum number of concurrent sessions the HTTP transport will hold in memory (only used when transport is 'http'). Each session holds a full server instance, transport, and timers, so choose a value…
  • MDB_MCP_MAX_TIME_M_S env
    Deprecated. Use `timeoutMs` instead. The maximum time in milliseconds that operations are allowed to run on the MongoDB server.
  • MDB_MCP_MCP_CLIENT_LOG_LEVEL env
    Minimum severity level for log messages forwarded to the MCP client.
  • MDB_MCP_MONITORING_SERVER_FEATURES env
    Features to expose on the monitoring server: health-check, metrics, and process-metrics. process-metrics exposes /metrics with Node.js process metrics (only used when transport is 'http' and monitori…
  • MDB_MCP_MONITORING_SERVER_HOST env
    Host address to bind the monitoring HTTP server to (only used when transport is 'http'). If provided, `monitoringServerPort` must also be set.
  • MDB_MCP_MONITORING_SERVER_PORT env
    Port number for the monitoring HTTP server (only used when transport is 'http'). If provided, `monitoringServerHost` must also be set.
  • MDB_MCP_NOTIFICATION_TIMEOUT_MS env
    Notification timeout for a client to be aware of disconnect (only applies to http transport).
  • MDB_MCP_PREVIEW_FEATURES env
    Comma separated values of preview features that are enabled.
  • MDB_MCP_QUERY_COUNT_MAX_TIME_MS_CAP env
    Deprecated. Use `queryCountTimeoutMs` instead.
  • MDB_MCP_QUERY_COUNT_TIMEOUT_MS env
    The maximum time in milliseconds for the count phase of find operations. This is used to limit the time spent counting documents when determining if results were capped.
  • MDB_MCP_READ_ONLY env
    When set to true, only allows read, connect, and metadata operation types, disabling create/update/delete operations.
  • MDB_MCP_TELEMETRY env
    When set to disabled, disables telemetry collection.
  • MDB_MCP_TIMEOUT_MS env
    The maximum time in milliseconds that MongoDB operations are allowed to run, applied as the driver's timeoutMS (client-side operation timeout, CSOT) on each connection. It bounds the entire operation…
  • MDB_MCP_TRANSPORT env
    Either 'stdio' or 'http'.
  • MDB_MCP_VOYAGE_API_KEY secret env
    API key for Voyage AI embeddings service (required for creating Atlas Local deployments with auto-embed vector search capabilities).

Values marked secret are keys to your account. Never share them or paste them into a chat.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 5, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account mongodb-js, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed today

  • ✓ Pass

    Has a licence

    Uses Apache-2.0

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Needs the server’s tool list first; this check starts in the next step

Compared with others in Databases & datasetsi

  • More stars than 67% of the other 3 servers in this category
  • Published to the registry more recently than 100% of the other 3 servers in this category
  • Basic checks equal to or better than 100% of the other 3 servers in this category

Compared only with servers in this prototype, not the whole registry.

Common questions

Is MongoDB MCP Server safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: MDB_MCP_API_CLIENT_ID, MDB_MCP_API_CLIENT_SECRET, MDB_MCP_CONNECTION_STRING, MDB_MCP_CONNECTION_STRINGS, MDB_MCP_VOYAGE_API_KEY

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed today, and the latest version (3.2.2) reached the registry yesterday.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js, Docker on your computer.

What can I use instead?

In the same category: Supabase, Elasticsearch MCP Server, Postgres MCP

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Supabase

by supabase

Supabase’s official server lets AI create tables, query data and review project settings in your Supabase database.

Computer or cloud★ 2,993Apache-2.0Updated 22 days ago

MCP server for interacting with Elasticsearch

Runs on your computer★ 315Apache-2.0Updated 14 months ago

Postgres MCP

by pgEdge

Enterprise PostgreSQL MCP server with NL queries, hybrid search (pgvector+BM25), and web UI

Runs on your computer★ 244PostgreSQLUpdated 10 months ago

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

MongoDB MCP Server

A Model Context Protocol server for interacting with MongoDB Databases and MongoDB Atlas.

Quick Start
Using the official MongoDB plugins for AI agents

MongoDB MCP Server comes bundled with the official MongoDB plugins for AI agents. The following plugins are available:

`mongodb-atlas` — connects to the MongoDB-hosted Atlas MCP server over OAuth. This does not require you to run anything locally, and is the recommended way to connect to MongoDB Atlas from your AI agent:

  • Cursor: marketplace
  • VSCode: Open the Extensions view (⇧⌘X / Ctrl+Shift+X), search for @agentPlugins, and install mongodb-atlas.
  • Claude: marketplace
  • Codex: Open /plugins and install mongodb-atlas.
  • GitHub Copilot CLI: Run copilot plugin install mongodb-atlas.
  • Grok: Open /marketplace in Grok Build and install mongodb-atlas.

`mongodb` — runs the MongoDB MCP server locally and connects to any self-managed deployment:

  • Cursor: marketplace
  • Claude: marketplace
  • Gemini: marketplace
  • Codex: Run codex plugin marketplace add mongodb/agent-skills, then open /plugins and install mongodb.
  • GitHub Copilot CLI: Run copilot plugin install mongodb.
  • Grok: Open /marketplace in Grok Build and install mongodb.
Using the setup script

You can manually set up the local MCP server by running the following command:

npx -y mongodb-mcp-server@latest setup

This will guide you through an interactive setup process, including configuring your MongoDB connection string or Atlas API credentials.

For more advanced setup options, see the Manual Setup section below.

Using the MongoDB MCP Server setup skill

You can add and use the MongoDB MCP Server setup skill to configure your local MCP server using an AI agent.

npx skills add https://github.com/mongodb/agent-skills --skill mongodb-mcp-setup
Using manual configuration

See Manual Setup for instructions on how to manually configure the MongoDB MCP Server.

📚 Table of Contents

  • 🚀 Getting Started
  • Prerequisites
  • Manual Setup
  • 🛠️ Supported Tools
  • MongoDB Atlas Tools
  • MongoDB Database Tools
  • MongoDB Assistant Tools
  • 📄 Supported Resources
  • ⚙️ Configuration
  • Configuration Options
  • Atlas API Access
  • Configuration Methods
  • Environment Variables
  • Command-Line Arguments
  • MCP Client Configuration
  • Proxy Support
  • 🚀 Deploy on Public Clouds
  • Azure Cloud
  • 🤝 Contributing

Prerequisites

[!NOTE]

Node 20.x support is deprecated and will be removed in a future release. Please upgrade to Node 22.13 or later. See https://nodejs.org/en/blog/migrations/v20-to-v22 for migration details.

  • Node.js
  • At least v22.13.0. Check with node -v.
  • A MongoDB connection string or Atlas API credentials.
  • _Service Accounts Atlas API credentials_ are required to use the Atlas tools. You can create a service account in MongoDB Atlas and use its credentials for authentication. See Atlas API Access for more details.
  • If you have a MongoDB connection string, you can use it directly to connect to your MongoDB instance.

Manual Setup

🔒 Security Recommendation 1: When using Atlas API credentials, be sure to assign only the minimum required permissions to your service account. See Atlas API Permissions for details.

🔒 Security Recommendation 2: For enhanced security, we strongly recommend using environment variables to pass sensitive configuration such as connection strings and API credentials instead of command line arguments. Command line arguments can be visible in process lists and logged in various system locations, potentially exposing your secrets. Environment variables provide a more secure way to handle sensitive information.

Most MCP clients require a configuration file to be created or modified to add the MCP server.

Note: The configuration file syntax can be different across clients. Please refer to the following links for the latest expected syntax:

Default Safety Notice: All examples below include --readOnly by default to ensure safe, read-only access to your data. Remove --readOnly if you need to enable write operations.

Option 1: Connection String

You can pass your connection string via environment variables, make sure to use a valid username and password.

{

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

NOTE: The connection string can be configured to connect to any MongoDB cluster, whether it's a local instance or an Atlas cluster.

Option 2: Connect to the MongoDB Atlas-Managed MCP Server

When working with MongoDB Atlas, the recommended approach is to install the mongodb-atlas plugin for your AI agent, which handles OAuth authentication automatically.

For manual configuration, see the client-specific instructions for setting up the Atlas Remote MCP server with OAuth. Alternatively, you can connect using the mongodb-atlas-mcp-remote package with Service Account credentials — see the package README for setup instructions.

Note: You cannot authenticate to the remote MongoDB MCP server using a static API key over HTTP. You must either:

- Use a client that supports the OAuth flow.

- Use the mongodb-atlas-mcp-remote stdio server, which you can authenticate into using the static MDB_MCP_API_CLIENT_ID and MDB_MCP_API_CLIENT_SECRET environment variables.

To connect with the mongodb-atlas-mcp-remote stdio server using Service Account credentials, add it to your client's MCP configuration:

{

"mcpServers": { "mongodb-atlas-mcp-remote": { "type": "stdio", "command": "npx", "args": ["-y", "mongodb-atlas-mcp-remote@latest"], "env": { "MDB_MCP_API_CLIENT_ID": "$CLIENT_ID", "MDB_MCP_API_CLIENT_SECRET": "$SECRET" } } } }

Option 3: Atlas API Credentials

Use your Atlas API Service Accounts credentials. Must follow all the steps in Atlas API Access section.

{

"mcpServers": { "MongoDB": { "command": "npx", "args": ["-y", "mongodb-mcp-server@latest", "--readOnly"], "env": { "MDB_MCP_API_CLIENT_ID": "your-atlas-service-accounts-client-id", "MDB_MCP_API_CLIENT_SECRET": "your-atlas-service-accounts-client-secret" } } } }

Option 4: Standalone Servic

Only the beginning is shown; read the rest in the repo

Ask PopNx