Enables GitHub Copilot to interact with MongoDB databases through the MCP server, allowing natural language queries and operations against MongoDB resources.
Provides tools for interacting with MongoDB Atlas resources and databases, supporting operations like querying, aggregation, document creation/modification, collection management, index creation, and database administration.
A Model Context Protocol server for interacting with MongoDB Databases and MongoDB Atlas.
Most MCP clients require a configuration file to be created or modified to add the MCP server.
You can pass your connection string via args, make sure to use a valid username and password.
Use your Atlas API Service Account credentials. More details in the Atlas API Access section.
Alternatively you can use environment variables in the config file or set them and run the server via npx.
atlas-list-orgs - Lists MongoDB Atlas organizationsatlas-list-projects - Lists MongoDB Atlas projectsatlas-create-project - Creates a new MongoDB Atlas projectatlas-list-clusters - Lists MongoDB Atlas clustersatlas-inspect-cluster - Inspect a specific MongoDB Atlas clusteratlas-create-free-cluster - Create a free MongoDB Atlas clusteratlas-connect-cluster - Connects to MongoDB Atlas clusteratlas-inspect-access-list - Inspect IP/CIDR ranges with access to MongoDB Atlas clustersatlas-create-access-list - Configure IP/CIDR access list for MongoDB Atlas clustersatlas-list-db-users - List MongoDB Atlas database usersatlas-create-db-user - List MongoDB Atlas database usersNOTE: atlas tools are only available when you set credentials on configuration section.
connect - Connect to a MongoDB instancefind - Run a find query against a MongoDB collectionaggregate - Run an aggregation against a MongoDB collectioncount - Get the number of documents in a MongoDB collectioninsert-one - Insert a single document into a MongoDB collectioninsert-many - Insert multiple documents into a MongoDB collectioncreate-index - Create an index for a MongoDB collectionupdate-one - Update a single document in a MongoDB collectionupdate-many - Update multiple documents in a MongoDB collectionrename-collection - Rename a MongoDB collectiondelete-one - Delete a single document from a MongoDB collectiondelete-many - Delete multiple documents from a MongoDB collectiondrop-collection - Remove a collection from a MongoDB databasedrop-database - Remove a MongoDB databaselist-databases - List all databases for a MongoDB connectionlist-collections - List all collections for a given databasecollection-indexes - Describe the indexes for a collectioncollection-schema - Describe the schema for a collectioncollection-storage-size - Get the size of a collection in MBdb-stats - Return statistics about a MongoDB databaseThe MongoDB MCP Server can be configured using multiple methods, with the following precedence (highest to lowest):
| Option | Description |
|---|---|
apiClientId | Atlas API client ID for authentication |
apiClientSecret | Atlas API client secret for authentication |
connectionString | MongoDB connection string for direct database connections (optional users may choose to inform it on every tool call) |
logPath | Folder to store logs |
disabledTools | An array of tool names, operation types, and/or categories of tools that will be disabled |
readOnly | When set to true, only allows read and metadata operation types, disabling create/update/delete operations |
telemetry | When set to disabled, disables telemetry collection |
Default log location is as follows:
%LOCALAPPDATA%\mongodb\mongodb-mcp\.app-logs~/.mongodb/mongodb-mcp/.app-logsYou can disable specific tools or categories of tools by using the disabledTools option. This option accepts an array of strings,
where each string can be a tool name, operation type, or category.
The way the array is constructed depends on the type of configuration method you use:
export MDB_MCP_DISABLED_TOOLS="create,update,delete,atlas,collectionSchema".--disabledTools create update delete atlas collectionSchema.Categories of tools:
atlas - MongoDB Atlas tools, such as list clusters, create cluster, etc.mongodb - MongoDB database tools, such as find, aggregate, etc.Operation types:
create - Tools that create resources, such as create cluster, insert document, etc.update - Tools that update resources, such as update document, rename collection, etc.delete - Tools that delete resources, such as delete document, drop collection, etc.read - Tools that read resources, such as find, aggregate, list clusters, etc.metadata - Tools that read metadata, such as list databases, list collections, collection schema, etc.The readOnly configuration option allows you to restrict the MCP server to only use tools with "read" and "metadata" operation types. When enabled, all tools that have "create", "update" or "delete" operation types will not be registered with the server.
This is useful for scenarios where you want to provide access to MongoDB data for analysis without allowing any modifications to the data or infrastructure.
You can enable read-only mode using:
export MDB_MCP_READ_ONLY=true--readOnlyWhen read-only mode is active, you'll see a message in the server logs indicating which tools were prevented from registering due to this restriction.
The telemetry configuration option allows you to disable telemetry collection. When enabled, the MCP server will collect usage data and send it to MongoDB.
You can disable telemetry using:
export MDB_MCP_TELEMETRY=disabled--telemetry disabledexport DO_NOT_TRACK=1To use the Atlas API tools, you'll need to create a service account in MongoDB Atlas:
To learn more about Service Accounts, check the MongoDB Atlas documentation.
apiClientId and apiClientSecretSet environment variables with the prefix MDB_MCP_ followed by the option name in uppercase with underscores:
Pass configuration options as command-line arguments when starting the server:
Interested in contributing? Great! Please check our Contributing Guide for guidelines on code contributions, standards, adding new tools, and troubleshooting information.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that enables AI assistants to interact with MongoDB Atlas resources through natural language, supporting database operations and Atlas management functions.