Connect Runs on your machine

Terminal

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

claude_desktop_config.json

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

~/.cursor/mcp.json

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

.vscode/mcp.json

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

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

Name	Description
`MDB_MCP_AGGREGATION_COUNT_MAX_TIME_MS_CAP` Optional	Deprecated. Use `aggregationCountTimeoutMs` instead.
`MDB_MCP_AGGREGATION_COUNT_TIMEOUT_MS` Optional	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` Optional	When set to true, allows configuration values to be overridden via request headers and query parameters.
`MDB_MCP_API_CLIENT_ID` Optional, secret	Atlas API client ID for authentication. Required for running Atlas tools.
`MDB_MCP_API_CLIENT_SECRET` Optional, secret	Atlas API client secret for authentication. Required for running Atlas tools.
`MDB_MCP_ASSISTANT_BASE_URL` Optional	Base URL for the MongoDB Assistant API.
`MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS` 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` Optional	Comma separated values of tool names that require user confirmation before execution. Requires the client to support elicitation.
`MDB_MCP_CONNECTION_IDLE_TIMEOUT_MS` Optional	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 of its connection scope; the preconfigured connection is excluded, and the reaper runs on this cade…
`MDB_MCP_CONNECTION_SCOPE` 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. With 'global', connections are shared across all sessions and survive ses…
`MDB_MCP_CONNECTION_STRING` Optional, secret	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 data. Deprecated: prefer the "preconfigured" entry of connectionStrings.
`MDB_MCP_CONNECTION_STRINGS` Optional, secret	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 directly, so one server can reach several deployments. Connections are opened on first use. Environment…
`MDB_MCP_DANGEROUS_HOST_BINDING` Optional	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 the server to the entire network and can allow unauthorized access. Off by default: the server refuses…
`MDB_MCP_DISABLE_SERVER_SIDE_JS` 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_DISABLE_UNTRUSTED_DATA_WARNING` Optional	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` Optional	Comma separated values of tool names, operation types, and/or categories of tools that will be disabled.
`MDB_MCP_DRY_RUN` 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` Optional	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` Optional	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 idleTimeoutMs when larger.
`MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS` Optional	Time in milliseconds between export cleanup cycles that remove expired export files.
`MDB_MCP_EXPORT_TIMEOUT_MS` Optional	Time in milliseconds after which an export is considered expired and eligible for cleanup.
`MDB_MCP_EXPORTS_PATH` Optional	Folder to store exported data files.
`MDB_MCP_EXTERNALLY_MANAGED_SESSIONS` Optional	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 implicitly re-initialized session restores the client's previously negotiated capabilities from the se…
`MDB_MCP_HEALTH_CHECK_HOST` 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` 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` 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` Optional	Header that the HTTP server will validate when making requests (only used when transport is 'http').
`MDB_MCP_HTTP_HOST` Optional	Host address to bind the HTTP server to (only used when transport is 'http').
`MDB_MCP_HTTP_PORT` Optional	Port number for the HTTP server (only used when transport is 'http'). Use 0 for a random port.
`MDB_MCP_HTTP_RESPONSE_TYPE` Optional	The HTTP response type for tool responses: 'sse' for Server-Sent Events, 'json' for standard JSON responses.
`MDB_MCP_IDLE_TIMEOUT_MS` Optional	Idle timeout for a client to disconnect (only applies to http transport).
`MDB_MCP_INDEX_CHECK` Optional	When set to true, enforces that query operations must use an index, rejecting queries that perform a collection scan.
`MDB_MCP_LOG_PATH` Optional	Folder to store logs.
`MDB_MCP_LOGGERS` Optional	Comma separated values of logger types.
`MDB_MCP_MAX_ACTIVE_CONNECTIONS` Optional	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 connectionId revoked. The preconfigured connection does not count towards the limit.
`MDB_MCP_MAX_BYTES_PER_QUERY` Optional	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` Optional	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` Optional	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 based on your deployment's available memory; the default is a conservative safety net rather than a…
`MDB_MCP_MAX_TIME_M_S` Optional	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` Optional	Minimum severity level for log messages forwarded to the MCP client.
`MDB_MCP_MONITORING_SERVER_FEATURES` Optional	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 monitoringServerHost/monitoringServerPort are set).
`MDB_MCP_MONITORING_SERVER_HOST` Optional	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` Optional	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` Optional	Notification timeout for a client to be aware of disconnect (only applies to http transport).
`MDB_MCP_PREVIEW_FEATURES` Optional	Comma separated values of preview features that are enabled.
`MDB_MCP_QUERY_COUNT_MAX_TIME_MS_CAP` Optional	Deprecated. Use `queryCountTimeoutMs` instead.
`MDB_MCP_QUERY_COUNT_TIMEOUT_MS` Optional	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` Optional	When set to true, only allows read, connect, and metadata operation types, disabling create/update/delete operations.
`MDB_MCP_TELEMETRY` Optional	When set to disabled, disables telemetry collection.
`MDB_MCP_TIMEOUT_MS` Optional	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, including server selection and network round trips.
`MDB_MCP_TRANSPORT` Optional	Either 'stdio' or 'http'.
`MDB_MCP_VOYAGE_API_KEY` Optional, secret	API key for Voyage AI embeddings service (required for creating Atlas Local deployments with auto-embed vector search capabilities).

Details

Package	`[email protected]` (NPM, stdio)
Package	`docker.io/mongodb/mongodb-mcp-server:3.3.0` (OCI, stdio)
First published	9 Nov 2026
Last updated	9 Nov 2026
Registry name	`io.github.mongodb-js/mongodb-mcp-server`

Mongodb Mcp Server

Connect Runs on your machine

Tools

Environment variables

Details

More databases servers See all