MCP Server

io.github.mongodb-js/mongodb-mcp-server MCP Server

Name: io.github.mongodb-js/mongodb-mcp-server MCP Server
Author: io.github.mongodb-js

io.github.mongodb-js/mongodb-mcp-server

Repository Registry

What is the io.github.mongodb-js/mongodb-mcp-server MCP server?

MongoDB Model Context Protocol Server

How to install io.github.mongodb-js/mongodb-mcp-server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

MDB_MCP_ALLOW_REQUEST_OVERRIDES
When set to true, allows configuration values to be overridden via request headers and query parameters.
MDB_MCP_API_CLIENT_ID
secret
Atlas API client ID for authentication. Required for running Atlas tools.
MDB_MCP_API_CLIENT_SECRET
secret
Atlas API client secret for authentication. Required for running Atlas tools.
MDB_MCP_ASSISTANT_BASE_URL
Base URL for the MongoDB Assistant API.
MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS
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
Comma separated values of tool names that require user confirmation before execution. Requires the client to support elicitation.
MDB_MCP_CONNECTION_STRING
secret
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
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
Comma separated values of tool names, operation types, and/or categories of tools that will be disabled.
MDB_MCP_DRY_RUN
When true, runs the server in dry mode: dumps configuration and enabled tools, then exits without starting the server.
MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS
Time in milliseconds between export cleanup cycles that remove expired export files.
MDB_MCP_EXPORT_TIMEOUT_MS
Time in milliseconds after which an export is considered expired and eligible for cleanup.
MDB_MCP_EXPORTS_PATH
Folder to store exported data files.
MDB_MCP_EXTERNALLY_MANAGED_SESSIONS
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
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
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
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
Header that the HTTP server will validate when making requests (only used when transport is 'http').
MDB_MCP_HTTP_HOST
Host address to bind the HTTP server to (only used when transport is 'http').
MDB_MCP_HTTP_PORT
Port number for the HTTP server (only used when transport is 'http'). Use 0 for a random port.
MDB_MCP_HTTP_RESPONSE_TYPE
The HTTP response type for tool responses: 'sse' for Server-Sent Events, 'json' for standard JSON responses.
MDB_MCP_IDLE_TIMEOUT_MS
Idle timeout for a client to disconnect (only applies to http transport).
MDB_MCP_INDEX_CHECK
When set to true, enforces that query operations must use an index, rejecting queries that perform a collection scan.
MDB_MCP_LOG_PATH
Folder to store logs.
MDB_MCP_LOGGERS
Comma separated values of logger types.
MDB_MCP_MAX_BYTES_PER_QUERY
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
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_TIME_M_S
The maximum time in milliseconds that operations are allowed to run on the MongoDB server. When set, this value is passed as the maxTimeMS option to read operations such as find, aggregate, and count.
MDB_MCP_MCP_CLIENT_LOG_LEVEL
Minimum severity level for log messages forwarded to the MCP client.
MDB_MCP_MONITORING_SERVER_FEATURES
Features to expose on the monitoring server (only used when transport is 'http' and monitoringServerHost/monitoringServerPort are set).
MDB_MCP_MONITORING_SERVER_HOST
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
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
Notification timeout for a client to be aware of disconnect (only applies to http transport).
MDB_MCP_PREVIEW_FEATURES
Comma separated values of preview features that are enabled.
MDB_MCP_READ_ONLY
When set to true, only allows read, connect, and metadata operation types, disabling create/update/delete operations.
MDB_MCP_TELEMETRY
When set to disabled, disables telemetry collection.
MDB_MCP_TRANSPORT
Either 'stdio' or 'http'.
MDB_MCP_VOYAGE_API_KEY
secret
API key for Voyage AI embeddings service (required for creating Atlas Local deployments with auto-embed vector search capabilities).

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mongodb-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server",
        "--allowRequestOverrides",
        "--apiClientId",
        "--apiClientSecret",
        "--assistantBaseUrl",
        "--atlasTemporaryDatabaseUserLifetimeMs",
        "--confirmationRequiredTools",
        "--connectionString",
        "--disableServerSideJs",
        "--disabledTools",
        "--dryRun",
        "--exportCleanupIntervalMs",
        "--exportTimeoutMs",
        "--exportsPath",
        "--externallyManagedSessions",
        "--healthCheckHost",
        "--healthCheckPort",
        "--httpBodyLimit",
        "--httpHeaders",
        "--httpHost",
        "--httpPort",
        "--httpResponseType",
        "--idleTimeoutMs",
        "--indexCheck",
        "--logPath",
        "--loggers",
        "--maxBytesPerQuery",
        "--maxDocumentsPerQuery",
        "--maxTimeMS",
        "--mcpClientLogLevel",
        "--monitoringServerFeatures",
        "--monitoringServerHost",
        "--monitoringServerPort",
        "--notificationTimeoutMs",
        "--previewFeatures",
        "--readOnly",
        "--telemetry",
        "--transport",
        "--voyageApiKey"
      ],
      "env": {
        "MDB_MCP_ALLOW_REQUEST_OVERRIDES": "<YOUR_MDB_MCP_ALLOW_REQUEST_OVERRIDES>",
        "MDB_MCP_API_CLIENT_ID": "<YOUR_MDB_MCP_API_CLIENT_ID>",
        "MDB_MCP_API_CLIENT_SECRET": "<YOUR_MDB_MCP_API_CLIENT_SECRET>",
        "MDB_MCP_ASSISTANT_BASE_URL": "<YOUR_MDB_MCP_ASSISTANT_BASE_URL>",
        "MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS": "<YOUR_MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS>",
        "MDB_MCP_CONFIRMATION_REQUIRED_TOOLS": "<YOUR_MDB_MCP_CONFIRMATION_REQUIRED_TOOLS>",
        "MDB_MCP_CONNECTION_STRING": "<YOUR_MDB_MCP_CONNECTION_STRING>",
        "MDB_MCP_DISABLE_SERVER_SIDE_JS": "<YOUR_MDB_MCP_DISABLE_SERVER_SIDE_JS>",
        "MDB_MCP_DISABLED_TOOLS": "<YOUR_MDB_MCP_DISABLED_TOOLS>",
        "MDB_MCP_DRY_RUN": "<YOUR_MDB_MCP_DRY_RUN>",
        "MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS": "<YOUR_MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS>",
        "MDB_MCP_EXPORT_TIMEOUT_MS": "<YOUR_MDB_MCP_EXPORT_TIMEOUT_MS>",
        "MDB_MCP_EXPORTS_PATH": "<YOUR_MDB_MCP_EXPORTS_PATH>",
        "MDB_MCP_EXTERNALLY_MANAGED_SESSIONS": "<YOUR_MDB_MCP_EXTERNALLY_MANAGED_SESSIONS>",
        "MDB_MCP_HEALTH_CHECK_HOST": "<YOUR_MDB_MCP_HEALTH_CHECK_HOST>",
        "MDB_MCP_HEALTH_CHECK_PORT": "<YOUR_MDB_MCP_HEALTH_CHECK_PORT>",
        "MDB_MCP_HTTP_BODY_LIMIT": "<YOUR_MDB_MCP_HTTP_BODY_LIMIT>",
        "MDB_MCP_HTTP_HEADERS": "<YOUR_MDB_MCP_HTTP_HEADERS>",
        "MDB_MCP_HTTP_HOST": "<YOUR_MDB_MCP_HTTP_HOST>",
        "MDB_MCP_HTTP_PORT": "<YOUR_MDB_MCP_HTTP_PORT>",
        "MDB_MCP_HTTP_RESPONSE_TYPE": "<YOUR_MDB_MCP_HTTP_RESPONSE_TYPE>",
        "MDB_MCP_IDLE_TIMEOUT_MS": "<YOUR_MDB_MCP_IDLE_TIMEOUT_MS>",
        "MDB_MCP_INDEX_CHECK": "<YOUR_MDB_MCP_INDEX_CHECK>",
        "MDB_MCP_LOG_PATH": "<YOUR_MDB_MCP_LOG_PATH>",
        "MDB_MCP_LOGGERS": "<YOUR_MDB_MCP_LOGGERS>",
        "MDB_MCP_MAX_BYTES_PER_QUERY": "<YOUR_MDB_MCP_MAX_BYTES_PER_QUERY>",
        "MDB_MCP_MAX_DOCUMENTS_PER_QUERY": "<YOUR_MDB_MCP_MAX_DOCUMENTS_PER_QUERY>",
        "MDB_MCP_MAX_TIME_M_S": "<YOUR_MDB_MCP_MAX_TIME_M_S>",
        "MDB_MCP_MCP_CLIENT_LOG_LEVEL": "<YOUR_MDB_MCP_MCP_CLIENT_LOG_LEVEL>",
        "MDB_MCP_MONITORING_SERVER_FEATURES": "<YOUR_MDB_MCP_MONITORING_SERVER_FEATURES>",
        "MDB_MCP_MONITORING_SERVER_HOST": "<YOUR_MDB_MCP_MONITORING_SERVER_HOST>",
        "MDB_MCP_MONITORING_SERVER_PORT": "<YOUR_MDB_MCP_MONITORING_SERVER_PORT>",
        "MDB_MCP_NOTIFICATION_TIMEOUT_MS": "<YOUR_MDB_MCP_NOTIFICATION_TIMEOUT_MS>",
        "MDB_MCP_PREVIEW_FEATURES": "<YOUR_MDB_MCP_PREVIEW_FEATURES>",
        "MDB_MCP_READ_ONLY": "<YOUR_MDB_MCP_READ_ONLY>",
        "MDB_MCP_TELEMETRY": "<YOUR_MDB_MCP_TELEMETRY>",
        "MDB_MCP_TRANSPORT": "<YOUR_MDB_MCP_TRANSPORT>",
        "MDB_MCP_VOYAGE_API_KEY": "<YOUR_MDB_MCP_VOYAGE_API_KEY>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mongodb-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server",
        "--allowRequestOverrides",
        "--apiClientId",
        "--apiClientSecret",
        "--assistantBaseUrl",
        "--atlasTemporaryDatabaseUserLifetimeMs",
        "--confirmationRequiredTools",
        "--connectionString",
        "--disableServerSideJs",
        "--disabledTools",
        "--dryRun",
        "--exportCleanupIntervalMs",
        "--exportTimeoutMs",
        "--exportsPath",
        "--externallyManagedSessions",
        "--healthCheckHost",
        "--healthCheckPort",
        "--httpBodyLimit",
        "--httpHeaders",
        "--httpHost",
        "--httpPort",
        "--httpResponseType",
        "--idleTimeoutMs",
        "--indexCheck",
        "--logPath",
        "--loggers",
        "--maxBytesPerQuery",
        "--maxDocumentsPerQuery",
        "--maxTimeMS",
        "--mcpClientLogLevel",
        "--monitoringServerFeatures",
        "--monitoringServerHost",
        "--monitoringServerPort",
        "--notificationTimeoutMs",
        "--previewFeatures",
        "--readOnly",
        "--telemetry",
        "--transport",
        "--voyageApiKey"
      ],
      "env": {
        "MDB_MCP_ALLOW_REQUEST_OVERRIDES": "<YOUR_MDB_MCP_ALLOW_REQUEST_OVERRIDES>",
        "MDB_MCP_API_CLIENT_ID": "<YOUR_MDB_MCP_API_CLIENT_ID>",
        "MDB_MCP_API_CLIENT_SECRET": "<YOUR_MDB_MCP_API_CLIENT_SECRET>",
        "MDB_MCP_ASSISTANT_BASE_URL": "<YOUR_MDB_MCP_ASSISTANT_BASE_URL>",
        "MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS": "<YOUR_MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS>",
        "MDB_MCP_CONFIRMATION_REQUIRED_TOOLS": "<YOUR_MDB_MCP_CONFIRMATION_REQUIRED_TOOLS>",
        "MDB_MCP_CONNECTION_STRING": "<YOUR_MDB_MCP_CONNECTION_STRING>",
        "MDB_MCP_DISABLE_SERVER_SIDE_JS": "<YOUR_MDB_MCP_DISABLE_SERVER_SIDE_JS>",
        "MDB_MCP_DISABLED_TOOLS": "<YOUR_MDB_MCP_DISABLED_TOOLS>",
        "MDB_MCP_DRY_RUN": "<YOUR_MDB_MCP_DRY_RUN>",
        "MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS": "<YOUR_MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS>",
        "MDB_MCP_EXPORT_TIMEOUT_MS": "<YOUR_MDB_MCP_EXPORT_TIMEOUT_MS>",
        "MDB_MCP_EXPORTS_PATH": "<YOUR_MDB_MCP_EXPORTS_PATH>",
        "MDB_MCP_EXTERNALLY_MANAGED_SESSIONS": "<YOUR_MDB_MCP_EXTERNALLY_MANAGED_SESSIONS>",
        "MDB_MCP_HEALTH_CHECK_HOST": "<YOUR_MDB_MCP_HEALTH_CHECK_HOST>",
        "MDB_MCP_HEALTH_CHECK_PORT": "<YOUR_MDB_MCP_HEALTH_CHECK_PORT>",
        "MDB_MCP_HTTP_BODY_LIMIT": "<YOUR_MDB_MCP_HTTP_BODY_LIMIT>",
        "MDB_MCP_HTTP_HEADERS": "<YOUR_MDB_MCP_HTTP_HEADERS>",
        "MDB_MCP_HTTP_HOST": "<YOUR_MDB_MCP_HTTP_HOST>",
        "MDB_MCP_HTTP_PORT": "<YOUR_MDB_MCP_HTTP_PORT>",
        "MDB_MCP_HTTP_RESPONSE_TYPE": "<YOUR_MDB_MCP_HTTP_RESPONSE_TYPE>",
        "MDB_MCP_IDLE_TIMEOUT_MS": "<YOUR_MDB_MCP_IDLE_TIMEOUT_MS>",
        "MDB_MCP_INDEX_CHECK": "<YOUR_MDB_MCP_INDEX_CHECK>",
        "MDB_MCP_LOG_PATH": "<YOUR_MDB_MCP_LOG_PATH>",
        "MDB_MCP_LOGGERS": "<YOUR_MDB_MCP_LOGGERS>",
        "MDB_MCP_MAX_BYTES_PER_QUERY": "<YOUR_MDB_MCP_MAX_BYTES_PER_QUERY>",
        "MDB_MCP_MAX_DOCUMENTS_PER_QUERY": "<YOUR_MDB_MCP_MAX_DOCUMENTS_PER_QUERY>",
        "MDB_MCP_MAX_TIME_M_S": "<YOUR_MDB_MCP_MAX_TIME_M_S>",
        "MDB_MCP_MCP_CLIENT_LOG_LEVEL": "<YOUR_MDB_MCP_MCP_CLIENT_LOG_LEVEL>",
        "MDB_MCP_MONITORING_SERVER_FEATURES": "<YOUR_MDB_MCP_MONITORING_SERVER_FEATURES>",
        "MDB_MCP_MONITORING_SERVER_HOST": "<YOUR_MDB_MCP_MONITORING_SERVER_HOST>",
        "MDB_MCP_MONITORING_SERVER_PORT": "<YOUR_MDB_MCP_MONITORING_SERVER_PORT>",
        "MDB_MCP_NOTIFICATION_TIMEOUT_MS": "<YOUR_MDB_MCP_NOTIFICATION_TIMEOUT_MS>",
        "MDB_MCP_PREVIEW_FEATURES": "<YOUR_MDB_MCP_PREVIEW_FEATURES>",
        "MDB_MCP_READ_ONLY": "<YOUR_MDB_MCP_READ_ONLY>",
        "MDB_MCP_TELEMETRY": "<YOUR_MDB_MCP_TELEMETRY>",
        "MDB_MCP_TRANSPORT": "<YOUR_MDB_MCP_TRANSPORT>",
        "MDB_MCP_VOYAGE_API_KEY": "<YOUR_MDB_MCP_VOYAGE_API_KEY>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mongodb-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server",
        "--allowRequestOverrides",
        "--apiClientId",
        "--apiClientSecret",
        "--assistantBaseUrl",
        "--atlasTemporaryDatabaseUserLifetimeMs",
        "--confirmationRequiredTools",
        "--connectionString",
        "--disableServerSideJs",
        "--disabledTools",
        "--dryRun",
        "--exportCleanupIntervalMs",
        "--exportTimeoutMs",
        "--exportsPath",
        "--externallyManagedSessions",
        "--healthCheckHost",
        "--healthCheckPort",
        "--httpBodyLimit",
        "--httpHeaders",
        "--httpHost",
        "--httpPort",
        "--httpResponseType",
        "--idleTimeoutMs",
        "--indexCheck",
        "--logPath",
        "--loggers",
        "--maxBytesPerQuery",
        "--maxDocumentsPerQuery",
        "--maxTimeMS",
        "--mcpClientLogLevel",
        "--monitoringServerFeatures",
        "--monitoringServerHost",
        "--monitoringServerPort",
        "--notificationTimeoutMs",
        "--previewFeatures",
        "--readOnly",
        "--telemetry",
        "--transport",
        "--voyageApiKey"
      ],
      "env": {
        "MDB_MCP_ALLOW_REQUEST_OVERRIDES": "<YOUR_MDB_MCP_ALLOW_REQUEST_OVERRIDES>",
        "MDB_MCP_API_CLIENT_ID": "<YOUR_MDB_MCP_API_CLIENT_ID>",
        "MDB_MCP_API_CLIENT_SECRET": "<YOUR_MDB_MCP_API_CLIENT_SECRET>",
        "MDB_MCP_ASSISTANT_BASE_URL": "<YOUR_MDB_MCP_ASSISTANT_BASE_URL>",
        "MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS": "<YOUR_MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS>",
        "MDB_MCP_CONFIRMATION_REQUIRED_TOOLS": "<YOUR_MDB_MCP_CONFIRMATION_REQUIRED_TOOLS>",
        "MDB_MCP_CONNECTION_STRING": "<YOUR_MDB_MCP_CONNECTION_STRING>",
        "MDB_MCP_DISABLE_SERVER_SIDE_JS": "<YOUR_MDB_MCP_DISABLE_SERVER_SIDE_JS>",
        "MDB_MCP_DISABLED_TOOLS": "<YOUR_MDB_MCP_DISABLED_TOOLS>",
        "MDB_MCP_DRY_RUN": "<YOUR_MDB_MCP_DRY_RUN>",
        "MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS": "<YOUR_MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS>",
        "MDB_MCP_EXPORT_TIMEOUT_MS": "<YOUR_MDB_MCP_EXPORT_TIMEOUT_MS>",
        "MDB_MCP_EXPORTS_PATH": "<YOUR_MDB_MCP_EXPORTS_PATH>",
        "MDB_MCP_EXTERNALLY_MANAGED_SESSIONS": "<YOUR_MDB_MCP_EXTERNALLY_MANAGED_SESSIONS>",
        "MDB_MCP_HEALTH_CHECK_HOST": "<YOUR_MDB_MCP_HEALTH_CHECK_HOST>",
        "MDB_MCP_HEALTH_CHECK_PORT": "<YOUR_MDB_MCP_HEALTH_CHECK_PORT>",
        "MDB_MCP_HTTP_BODY_LIMIT": "<YOUR_MDB_MCP_HTTP_BODY_LIMIT>",
        "MDB_MCP_HTTP_HEADERS": "<YOUR_MDB_MCP_HTTP_HEADERS>",
        "MDB_MCP_HTTP_HOST": "<YOUR_MDB_MCP_HTTP_HOST>",
        "MDB_MCP_HTTP_PORT": "<YOUR_MDB_MCP_HTTP_PORT>",
        "MDB_MCP_HTTP_RESPONSE_TYPE": "<YOUR_MDB_MCP_HTTP_RESPONSE_TYPE>",
        "MDB_MCP_IDLE_TIMEOUT_MS": "<YOUR_MDB_MCP_IDLE_TIMEOUT_MS>",
        "MDB_MCP_INDEX_CHECK": "<YOUR_MDB_MCP_INDEX_CHECK>",
        "MDB_MCP_LOG_PATH": "<YOUR_MDB_MCP_LOG_PATH>",
        "MDB_MCP_LOGGERS": "<YOUR_MDB_MCP_LOGGERS>",
        "MDB_MCP_MAX_BYTES_PER_QUERY": "<YOUR_MDB_MCP_MAX_BYTES_PER_QUERY>",
        "MDB_MCP_MAX_DOCUMENTS_PER_QUERY": "<YOUR_MDB_MCP_MAX_DOCUMENTS_PER_QUERY>",
        "MDB_MCP_MAX_TIME_M_S": "<YOUR_MDB_MCP_MAX_TIME_M_S>",
        "MDB_MCP_MCP_CLIENT_LOG_LEVEL": "<YOUR_MDB_MCP_MCP_CLIENT_LOG_LEVEL>",
        "MDB_MCP_MONITORING_SERVER_FEATURES": "<YOUR_MDB_MCP_MONITORING_SERVER_FEATURES>",
        "MDB_MCP_MONITORING_SERVER_HOST": "<YOUR_MDB_MCP_MONITORING_SERVER_HOST>",
        "MDB_MCP_MONITORING_SERVER_PORT": "<YOUR_MDB_MCP_MONITORING_SERVER_PORT>",
        "MDB_MCP_NOTIFICATION_TIMEOUT_MS": "<YOUR_MDB_MCP_NOTIFICATION_TIMEOUT_MS>",
        "MDB_MCP_PREVIEW_FEATURES": "<YOUR_MDB_MCP_PREVIEW_FEATURES>",
        "MDB_MCP_READ_ONLY": "<YOUR_MDB_MCP_READ_ONLY>",
        "MDB_MCP_TELEMETRY": "<YOUR_MDB_MCP_TELEMETRY>",
        "MDB_MCP_TRANSPORT": "<YOUR_MDB_MCP_TRANSPORT>",
        "MDB_MCP_VOYAGE_API_KEY": "<YOUR_MDB_MCP_VOYAGE_API_KEY>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mongodb-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server",
        "--allowRequestOverrides",
        "--apiClientId",
        "--apiClientSecret",
        "--assistantBaseUrl",
        "--atlasTemporaryDatabaseUserLifetimeMs",
        "--confirmationRequiredTools",
        "--connectionString",
        "--disableServerSideJs",
        "--disabledTools",
        "--dryRun",
        "--exportCleanupIntervalMs",
        "--exportTimeoutMs",
        "--exportsPath",
        "--externallyManagedSessions",
        "--healthCheckHost",
        "--healthCheckPort",
        "--httpBodyLimit",
        "--httpHeaders",
        "--httpHost",
        "--httpPort",
        "--httpResponseType",
        "--idleTimeoutMs",
        "--indexCheck",
        "--logPath",
        "--loggers",
        "--maxBytesPerQuery",
        "--maxDocumentsPerQuery",
        "--maxTimeMS",
        "--mcpClientLogLevel",
        "--monitoringServerFeatures",
        "--monitoringServerHost",
        "--monitoringServerPort",
        "--notificationTimeoutMs",
        "--previewFeatures",
        "--readOnly",
        "--telemetry",
        "--transport",
        "--voyageApiKey"
      ],
      "env": {
        "MDB_MCP_ALLOW_REQUEST_OVERRIDES": "<YOUR_MDB_MCP_ALLOW_REQUEST_OVERRIDES>",
        "MDB_MCP_API_CLIENT_ID": "<YOUR_MDB_MCP_API_CLIENT_ID>",
        "MDB_MCP_API_CLIENT_SECRET": "<YOUR_MDB_MCP_API_CLIENT_SECRET>",
        "MDB_MCP_ASSISTANT_BASE_URL": "<YOUR_MDB_MCP_ASSISTANT_BASE_URL>",
        "MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS": "<YOUR_MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS>",
        "MDB_MCP_CONFIRMATION_REQUIRED_TOOLS": "<YOUR_MDB_MCP_CONFIRMATION_REQUIRED_TOOLS>",
        "MDB_MCP_CONNECTION_STRING": "<YOUR_MDB_MCP_CONNECTION_STRING>",
        "MDB_MCP_DISABLE_SERVER_SIDE_JS": "<YOUR_MDB_MCP_DISABLE_SERVER_SIDE_JS>",
        "MDB_MCP_DISABLED_TOOLS": "<YOUR_MDB_MCP_DISABLED_TOOLS>",
        "MDB_MCP_DRY_RUN": "<YOUR_MDB_MCP_DRY_RUN>",
        "MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS": "<YOUR_MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS>",
        "MDB_MCP_EXPORT_TIMEOUT_MS": "<YOUR_MDB_MCP_EXPORT_TIMEOUT_MS>",
        "MDB_MCP_EXPORTS_PATH": "<YOUR_MDB_MCP_EXPORTS_PATH>",
        "MDB_MCP_EXTERNALLY_MANAGED_SESSIONS": "<YOUR_MDB_MCP_EXTERNALLY_MANAGED_SESSIONS>",
        "MDB_MCP_HEALTH_CHECK_HOST": "<YOUR_MDB_MCP_HEALTH_CHECK_HOST>",
        "MDB_MCP_HEALTH_CHECK_PORT": "<YOUR_MDB_MCP_HEALTH_CHECK_PORT>",
        "MDB_MCP_HTTP_BODY_LIMIT": "<YOUR_MDB_MCP_HTTP_BODY_LIMIT>",
        "MDB_MCP_HTTP_HEADERS": "<YOUR_MDB_MCP_HTTP_HEADERS>",
        "MDB_MCP_HTTP_HOST": "<YOUR_MDB_MCP_HTTP_HOST>",
        "MDB_MCP_HTTP_PORT": "<YOUR_MDB_MCP_HTTP_PORT>",
        "MDB_MCP_HTTP_RESPONSE_TYPE": "<YOUR_MDB_MCP_HTTP_RESPONSE_TYPE>",
        "MDB_MCP_IDLE_TIMEOUT_MS": "<YOUR_MDB_MCP_IDLE_TIMEOUT_MS>",
        "MDB_MCP_INDEX_CHECK": "<YOUR_MDB_MCP_INDEX_CHECK>",
        "MDB_MCP_LOG_PATH": "<YOUR_MDB_MCP_LOG_PATH>",
        "MDB_MCP_LOGGERS": "<YOUR_MDB_MCP_LOGGERS>",
        "MDB_MCP_MAX_BYTES_PER_QUERY": "<YOUR_MDB_MCP_MAX_BYTES_PER_QUERY>",
        "MDB_MCP_MAX_DOCUMENTS_PER_QUERY": "<YOUR_MDB_MCP_MAX_DOCUMENTS_PER_QUERY>",
        "MDB_MCP_MAX_TIME_M_S": "<YOUR_MDB_MCP_MAX_TIME_M_S>",
        "MDB_MCP_MCP_CLIENT_LOG_LEVEL": "<YOUR_MDB_MCP_MCP_CLIENT_LOG_LEVEL>",
        "MDB_MCP_MONITORING_SERVER_FEATURES": "<YOUR_MDB_MCP_MONITORING_SERVER_FEATURES>",
        "MDB_MCP_MONITORING_SERVER_HOST": "<YOUR_MDB_MCP_MONITORING_SERVER_HOST>",
        "MDB_MCP_MONITORING_SERVER_PORT": "<YOUR_MDB_MCP_MONITORING_SERVER_PORT>",
        "MDB_MCP_NOTIFICATION_TIMEOUT_MS": "<YOUR_MDB_MCP_NOTIFICATION_TIMEOUT_MS>",
        "MDB_MCP_PREVIEW_FEATURES": "<YOUR_MDB_MCP_PREVIEW_FEATURES>",
        "MDB_MCP_READ_ONLY": "<YOUR_MDB_MCP_READ_ONLY>",
        "MDB_MCP_TELEMETRY": "<YOUR_MDB_MCP_TELEMETRY>",
        "MDB_MCP_TRANSPORT": "<YOUR_MDB_MCP_TRANSPORT>",
        "MDB_MCP_VOYAGE_API_KEY": "<YOUR_MDB_MCP_VOYAGE_API_KEY>"
      }
    }
  }
}

Claude Code

claude mcp add mongodb-mcp-server --env MDB_MCP_ALLOW_REQUEST_OVERRIDES=<YOUR_MDB_MCP_ALLOW_REQUEST_OVERRIDES> --env MDB_MCP_API_CLIENT_ID=<YOUR_MDB_MCP_API_CLIENT_ID> --env MDB_MCP_API_CLIENT_SECRET=<YOUR_MDB_MCP_API_CLIENT_SECRET> --env MDB_MCP_ASSISTANT_BASE_URL=<YOUR_MDB_MCP_ASSISTANT_BASE_URL> --env MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS=<YOUR_MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS> --env MDB_MCP_CONFIRMATION_REQUIRED_TOOLS=<YOUR_MDB_MCP_CONFIRMATION_REQUIRED_TOOLS> --env MDB_MCP_CONNECTION_STRING=<YOUR_MDB_MCP_CONNECTION_STRING> --env MDB_MCP_DISABLE_SERVER_SIDE_JS=<YOUR_MDB_MCP_DISABLE_SERVER_SIDE_JS> --env MDB_MCP_DISABLED_TOOLS=<YOUR_MDB_MCP_DISABLED_TOOLS> --env MDB_MCP_DRY_RUN=<YOUR_MDB_MCP_DRY_RUN> --env MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS=<YOUR_MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS> --env MDB_MCP_EXPORT_TIMEOUT_MS=<YOUR_MDB_MCP_EXPORT_TIMEOUT_MS> --env MDB_MCP_EXPORTS_PATH=<YOUR_MDB_MCP_EXPORTS_PATH> --env MDB_MCP_EXTERNALLY_MANAGED_SESSIONS=<YOUR_MDB_MCP_EXTERNALLY_MANAGED_SESSIONS> --env MDB_MCP_HEALTH_CHECK_HOST=<YOUR_MDB_MCP_HEALTH_CHECK_HOST> --env MDB_MCP_HEALTH_CHECK_PORT=<YOUR_MDB_MCP_HEALTH_CHECK_PORT> --env MDB_MCP_HTTP_BODY_LIMIT=<YOUR_MDB_MCP_HTTP_BODY_LIMIT> --env MDB_MCP_HTTP_HEADERS=<YOUR_MDB_MCP_HTTP_HEADERS> --env MDB_MCP_HTTP_HOST=<YOUR_MDB_MCP_HTTP_HOST> --env MDB_MCP_HTTP_PORT=<YOUR_MDB_MCP_HTTP_PORT> --env MDB_MCP_HTTP_RESPONSE_TYPE=<YOUR_MDB_MCP_HTTP_RESPONSE_TYPE> --env MDB_MCP_IDLE_TIMEOUT_MS=<YOUR_MDB_MCP_IDLE_TIMEOUT_MS> --env MDB_MCP_INDEX_CHECK=<YOUR_MDB_MCP_INDEX_CHECK> --env MDB_MCP_LOG_PATH=<YOUR_MDB_MCP_LOG_PATH> --env MDB_MCP_LOGGERS=<YOUR_MDB_MCP_LOGGERS> --env MDB_MCP_MAX_BYTES_PER_QUERY=<YOUR_MDB_MCP_MAX_BYTES_PER_QUERY> --env MDB_MCP_MAX_DOCUMENTS_PER_QUERY=<YOUR_MDB_MCP_MAX_DOCUMENTS_PER_QUERY> --env MDB_MCP_MAX_TIME_M_S=<YOUR_MDB_MCP_MAX_TIME_M_S> --env MDB_MCP_MCP_CLIENT_LOG_LEVEL=<YOUR_MDB_MCP_MCP_CLIENT_LOG_LEVEL> --env MDB_MCP_MONITORING_SERVER_FEATURES=<YOUR_MDB_MCP_MONITORING_SERVER_FEATURES> --env MDB_MCP_MONITORING_SERVER_HOST=<YOUR_MDB_MCP_MONITORING_SERVER_HOST> --env MDB_MCP_MONITORING_SERVER_PORT=<YOUR_MDB_MCP_MONITORING_SERVER_PORT> --env MDB_MCP_NOTIFICATION_TIMEOUT_MS=<YOUR_MDB_MCP_NOTIFICATION_TIMEOUT_MS> --env MDB_MCP_PREVIEW_FEATURES=<YOUR_MDB_MCP_PREVIEW_FEATURES> --env MDB_MCP_READ_ONLY=<YOUR_MDB_MCP_READ_ONLY> --env MDB_MCP_TELEMETRY=<YOUR_MDB_MCP_TELEMETRY> --env MDB_MCP_TRANSPORT=<YOUR_MDB_MCP_TRANSPORT> --env MDB_MCP_VOYAGE_API_KEY=<YOUR_MDB_MCP_VOYAGE_API_KEY> -- npx -y mongodb-mcp-server --allowRequestOverrides --apiClientId --apiClientSecret --assistantBaseUrl --atlasTemporaryDatabaseUserLifetimeMs --confirmationRequiredTools --connectionString --disableServerSideJs --disabledTools --dryRun --exportCleanupIntervalMs --exportTimeoutMs --exportsPath --externallyManagedSessions --healthCheckHost --healthCheckPort --httpBodyLimit --httpHeaders --httpHost --httpPort --httpResponseType --idleTimeoutMs --indexCheck --logPath --loggers --maxBytesPerQuery --maxDocumentsPerQuery --maxTimeMS --mcpClientLogLevel --monitoringServerFeatures --monitoringServerHost --monitoringServerPort --notificationTimeoutMs --previewFeatures --readOnly --telemetry --transport --voyageApiKey