io.github.mongodb-js/mongodb-mcp-server
MongoDB Model Context Protocol Server
{
"mcpServers": {
"mongodb-mcp-server": {
"command": "npx",
"args": [
"-y",
"mongodb-mcp-server"
],
"env": {
"MDB_MCP_ALLOW_REQUEST_OVERRIDES": "<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": "<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_STRING": "<your-mdb_mcp_connection_string>",
"MDB_MCP_DISABLED_TOOLS": "<mdb_mcp_disabled_tools>",
"MDB_MCP_DRY_RUN": "<mdb_mcp_dry_run>",
"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_BYTES_PER_QUERY": "<mdb_mcp_max_bytes_per_query>",
"MDB_MCP_MAX_DOCUMENTS_PER_QUERY": "<mdb_mcp_max_documents_per_query>",
"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_READ_ONLY": "<mdb_mcp_read_only>",
"MDB_MCP_TELEMETRY": "<mdb_mcp_telemetry>",
"MDB_MCP_TRANSPORT": "<mdb_mcp_transport>",
"MDB_MCP_VOYAGE_API_KEY": "<your-mdb_mcp_voyage_api_key>"
}
}
}
}{
"mcpServers": {
"mongodb-mcp-server": {
"command": "npx",
"args": [
"-y",
"mongodb-mcp-server"
],
"env": {
"MDB_MCP_ALLOW_REQUEST_OVERRIDES": "<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": "<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_STRING": "<your-mdb_mcp_connection_string>",
"MDB_MCP_DISABLED_TOOLS": "<mdb_mcp_disabled_tools>",
"MDB_MCP_DRY_RUN": "<mdb_mcp_dry_run>",
"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_BYTES_PER_QUERY": "<mdb_mcp_max_bytes_per_query>",
"MDB_MCP_MAX_DOCUMENTS_PER_QUERY": "<mdb_mcp_max_documents_per_query>",
"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_READ_ONLY": "<mdb_mcp_read_only>",
"MDB_MCP_TELEMETRY": "<mdb_mcp_telemetry>",
"MDB_MCP_TRANSPORT": "<mdb_mcp_transport>",
"MDB_MCP_VOYAGE_API_KEY": "<your-mdb_mcp_voyage_api_key>"
}
}
}
}npx -y mongodb-mcp-server{
"mcpServers": {
"mongodb-mcp-server": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"docker.io/mongodb/mongodb-mcp-server:1.10.0"
],
"env": {
"MDB_MCP_ALLOW_REQUEST_OVERRIDES": "<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": "<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_STRING": "<your-mdb_mcp_connection_string>",
"MDB_MCP_DISABLED_TOOLS": "<mdb_mcp_disabled_tools>",
"MDB_MCP_DRY_RUN": "<mdb_mcp_dry_run>",
"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_BYTES_PER_QUERY": "<mdb_mcp_max_bytes_per_query>",
"MDB_MCP_MAX_DOCUMENTS_PER_QUERY": "<mdb_mcp_max_documents_per_query>",
"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_READ_ONLY": "<mdb_mcp_read_only>",
"MDB_MCP_TELEMETRY": "<mdb_mcp_telemetry>",
"MDB_MCP_TRANSPORT": "<mdb_mcp_transport>",
"MDB_MCP_VOYAGE_API_KEY": "<your-mdb_mcp_voyage_api_key>"
}
}
}
}MDB_MCP_ALLOW_REQUEST_OVERRIDESWhen set to true, allows configuration values to be overridden via request headers and query parameters.
MDB_MCP_API_CLIENT_IDAtlas API client ID for authentication. Required for running Atlas tools.
MDB_MCP_API_CLIENT_SECRETAtlas API client secret for authentication. Required for running Atlas tools.
MDB_MCP_ASSISTANT_BASE_URLBase URL for the MongoDB Assistant API.
MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MSTime in milliseconds that temporary database users created when connecting to MongoDB Atlas clusters will remain active before being automatically deleted.
MDB_MCP_CONFIRMATION_REQUIRED_TOOLSComma separated values of tool names that require user confirmation before execution. Requires the client to support elicitation.
MDB_MCP_CONNECTION_STRINGMongoDB 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_DISABLED_TOOLSComma separated values of tool names, operation types, and/or categories of tools that will be disabled.
MDB_MCP_DRY_RUNWhen true, runs the server in dry mode: dumps configuration and enabled tools, then exits without starting the server.
MDB_MCP_EXPORT_CLEANUP_INTERVAL_MSTime in milliseconds between export cleanup cycles that remove expired export files.
MDB_MCP_EXPORT_TIMEOUT_MSTime in milliseconds after which an export is considered expired and eligible for cleanup.
MDB_MCP_EXPORTS_PATHFolder to store exported data files.
MDB_MCP_EXTERNALLY_MANAGED_SESSIONSWhen 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_HOSTDeprecated. 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_PORTDeprecated. 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_LIMITMaximum 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_HEADERSHeader that the HTTP server will validate when making requests (only used when transport is 'http').
MDB_MCP_HTTP_HOSTHost address to bind the HTTP server to (only used when transport is 'http').
MDB_MCP_HTTP_PORTPort number for the HTTP server (only used when transport is 'http'). Use 0 for a random port.
MDB_MCP_HTTP_RESPONSE_TYPEThe HTTP response type for tool responses: 'sse' for Server-Sent Events, 'json' for standard JSON responses.
MDB_MCP_IDLE_TIMEOUT_MSIdle timeout for a client to disconnect (only applies to http transport).
MDB_MCP_INDEX_CHECKWhen set to true, enforces that query operations must use an index, rejecting queries that perform a collection scan.
MDB_MCP_LOG_PATHFolder to store logs.
MDB_MCP_LOGGERSComma separated values of logger types.
MDB_MCP_MAX_BYTES_PER_QUERYThe 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_QUERYThe 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_SThe 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_LEVELMinimum severity level for log messages forwarded to the MCP client.
MDB_MCP_MONITORING_SERVER_FEATURESFeatures to expose on the monitoring server (only used when transport is 'http' and monitoringServerHost/monitoringServerPort are set).
MDB_MCP_MONITORING_SERVER_HOSTHost 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_PORTPort number for the monitoring HTTP server (only used when transport is 'http'). If provided, `monitoringServerHost` must also be set.
MDB_MCP_NOTIFICATION_TIMEOUT_MSNotification timeout for a client to be aware of disconnect (only applies to http transport).
MDB_MCP_PREVIEW_FEATURESComma separated values of preview features that are enabled.
MDB_MCP_READ_ONLYWhen set to true, only allows read, connect, and metadata operation types, disabling create/update/delete operations.
MDB_MCP_TELEMETRYWhen set to disabled, disables telemetry collection.
MDB_MCP_TRANSPORTEither 'stdio' or 'http'.
MDB_MCP_VOYAGE_API_KEYAPI key for Voyage AI embeddings service (required for creating Atlas Local deployments with auto-embed vector search capabilities).
MDB_MCP_ALLOW_REQUEST_OVERRIDESWhen set to true, allows configuration values to be overridden via request headers and query parameters.
MDB_MCP_API_CLIENT_IDAtlas API client ID for authentication. Required for running Atlas tools.
MDB_MCP_API_CLIENT_SECRETAtlas API client secret for authentication. Required for running Atlas tools.
MDB_MCP_ASSISTANT_BASE_URLBase URL for the MongoDB Assistant API.
MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MSTime in milliseconds that temporary database users created when connecting to MongoDB Atlas clusters will remain active before being automatically deleted.
MDB_MCP_CONFIRMATION_REQUIRED_TOOLSComma separated values of tool names that require user confirmation before execution. Requires the client to support elicitation.
MDB_MCP_CONNECTION_STRINGMongoDB 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_DISABLED_TOOLSComma separated values of tool names, operation types, and/or categories of tools that will be disabled.
MDB_MCP_DRY_RUNWhen true, runs the server in dry mode: dumps configuration and enabled tools, then exits without starting the server.
MDB_MCP_EXPORT_CLEANUP_INTERVAL_MSTime in milliseconds between export cleanup cycles that remove expired export files.
MDB_MCP_EXPORT_TIMEOUT_MSTime in milliseconds after which an export is considered expired and eligible for cleanup.
MDB_MCP_EXPORTS_PATHFolder to store exported data files.
MDB_MCP_EXTERNALLY_MANAGED_SESSIONSWhen 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_HOSTDeprecated. 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_PORTDeprecated. 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_LIMITMaximum 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_HEADERSHeader that the HTTP server will validate when making requests (only used when transport is 'http').
MDB_MCP_HTTP_HOSTHost address to bind the HTTP server to (only used when transport is 'http').
MDB_MCP_HTTP_PORTPort number for the HTTP server (only used when transport is 'http'). Use 0 for a random port.
MDB_MCP_HTTP_RESPONSE_TYPEThe HTTP response type for tool responses: 'sse' for Server-Sent Events, 'json' for standard JSON responses.
MDB_MCP_IDLE_TIMEOUT_MSIdle timeout for a client to disconnect (only applies to http transport).
MDB_MCP_INDEX_CHECKWhen set to true, enforces that query operations must use an index, rejecting queries that perform a collection scan.
MDB_MCP_LOG_PATHFolder to store logs.
MDB_MCP_LOGGERSComma separated values of logger types.
MDB_MCP_MAX_BYTES_PER_QUERYThe 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_QUERYThe 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_SThe 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_LEVELMinimum severity level for log messages forwarded to the MCP client.
MDB_MCP_MONITORING_SERVER_FEATURESFeatures to expose on the monitoring server (only used when transport is 'http' and monitoringServerHost/monitoringServerPort are set).
MDB_MCP_MONITORING_SERVER_HOSTHost 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_PORTPort number for the monitoring HTTP server (only used when transport is 'http'). If provided, `monitoringServerHost` must also be set.
MDB_MCP_NOTIFICATION_TIMEOUT_MSNotification timeout for a client to be aware of disconnect (only applies to http transport).
MDB_MCP_PREVIEW_FEATURESComma separated values of preview features that are enabled.
MDB_MCP_READ_ONLYWhen set to true, only allows read, connect, and metadata operation types, disabling create/update/delete operations.
MDB_MCP_TELEMETRYWhen set to disabled, disables telemetry collection.
MDB_MCP_TRANSPORTEither 'stdio' or 'http'.
MDB_MCP_VOYAGE_API_KEYAPI key for Voyage AI embeddings service (required for creating Atlas Local deployments with auto-embed vector search capabilities).
Database MCP server for MySQL, MariaDB, PostgreSQL & SQLite
Manage Supabase projects end to end across database, auth, storage, realtime, and migrations. Moni…
Explore your Messages SQLite database to browse tables and inspect schemas with ease. Run flexible…