MongoDB MCP Server: Setup for Claude, Cursor and Other Apps

• Finds documents in a collection

  Runs a find query with an optional filter, sort and limit and returns the matching documents.

  Try: “Find the 10 most recent orders in the shop database where status is pending.”

  Read · find

• Runs an aggregation on a collection

  Runs an aggregation pipeline on one collection. Pipelines with a $out or $merge stage write to a collection and ask you to confirm first.

  Try: “Group the orders collection by customer and total the amount spent.”

  Write · aggregate

• Runs a database-level aggregation

  Runs an aggregation pipeline against a whole database instead of one collection. Pipelines with $out or $merge ask you to confirm first.

  Try: “List the current operations running on the database.”

  Write · aggregate-db

• Counts documents in a collection

  Counts the documents in a collection, optionally with a filter.

  Try: “How many users signed up this month?”

  Read · count

• Exports query results as EJSON

  Exports the result of a find or aggregation in EJSON format. The data is available as a resource and also saved to a path on your computer.

  Try: “Export all open support tickets to a file.”

  Files · export

• Shows how a query would run

  Returns the query plan for a find, aggregate or count, so you can see if it uses an index.

  Try: “Explain this find on orders by customer_id and tell me if it uses an index.”

  Read · explain

• Lists the databases on the connection

  Lists every database on the connected MongoDB instance.

  Try: “What databases are on this server?”

  Read · list-databases

• Lists collections in a database

  Lists the collections in one database.

  Try: “Show me the collections in the shop database.”

  Read · list-collections

• Describes the fields in a collection

  Samples documents from a collection and describes the fields and types it finds.

  Try: “What fields do documents in users have?”

  Read · collection-schema

• Lists indexes on a collection

  Describes the indexes on a collection.

  Try: “Which indexes exist on the orders collection?”

  Read · collection-indexes

• Gets the size of a collection

  Returns how much storage a collection uses.

  Try: “How big is the events collection?”

  Read · collection-storage-size

• Shows database statistics

  Returns usage statistics for one database, such as size and object counts.

  Try: “Give me the stats for the shop database.”

  Read · db-stats

• Reads recent server log events

  Returns the most recent logged events from the mongod server.

  Try: “Show recent warnings in the MongoDB logs.”

  Read · mongodb-logs

• Connects to a MongoDB instance

  Opens a connection from a connection string and returns a connection ID that other tools use. Several connections can be open at once.

  Try: “Connect to mongodb://localhost:27017.”

  Network · connect

• Closes a connection

  Closes a MongoDB connection and revokes its connection ID.

  Try: “Disconnect from the production cluster.”

  Network · disconnect

• Lists open connections

  Lists the active MongoDB connections and their IDs so you can reuse one.

  Try: “Which connections are open right now?”

  Read · list-connections

• Adds documents to a collection

  Inserts a list of documents into a collection. Very large lists should be sent in batches.

  Try: “Insert these three test users into the users collection.”

  Write · insert-many

• Changes documents that match a filter

  Updates every document in a collection that matches a filter.

  Try: “Set status to archived on all orders older than 2023.”

  Write · update-many

• Creates a collection

  Creates a collection in a database. The database is created too if it does not exist.

  Try: “Create a logs collection in the shop database.”

  Write · create-collection

• Creates an index

  Creates an index on a collection.

  Try: “Add an index on email in the users collection.”

  Write · create-index

• Renames a collection

  Renames a collection in a database.

  Try: “Rename temp_orders to orders_archive.”

  Write · rename-collection

• Deletes documents that match a filter

  Removes every document in a collection that matches the filter. It asks you to confirm by default.

  Try: “Delete all test users whose email ends in @example.com.”

  Delete · delete-many

• Deletes a collection

  Removes a collection or view and its indexes. It asks you to confirm by default.

  Try: “Drop the temp_orders collection.”

  Delete · drop-collection

• Deletes a whole database

  Removes a database and its data files. It asks you to confirm by default.

  Try: “Drop the staging database.”

  Delete · drop-database

• Deletes an index

  Drops an index from a collection. It asks you to confirm by default.

  Try: “Drop the old email_1 index on users.”

  Delete · drop-index

• Lists your Atlas organizations

  Lists the MongoDB Atlas organizations the credentials can see.

  Try: “Which Atlas organizations do I have?”

  Network · atlas-list-orgs

• Lists your Atlas projects

  Lists Atlas projects.

  Try: “List my Atlas projects.”

  Network · atlas-list-projects

• Lists Atlas clusters

  Lists the clusters in an Atlas project.

  Try: “What clusters are in my Production project?”

  Network · atlas-list-clusters

• Shows details of an Atlas cluster

  Returns metadata about one Atlas cluster.

  Try: “Show me the config of the orders-prod cluster.”

  Network · atlas-inspect-cluster

• Connects to an Atlas cluster

  Connects to an Atlas cluster and returns a connection ID for the database tools. It creates a temporary database user to do so.

  Try: “Connect to the orders-prod cluster.”

  Write · atlas-connect-cluster

• Lists Atlas database users

  Lists the database users in an Atlas project.

  Try: “Which database users exist in this project?”

  Network · atlas-list-db-users

• Shows allowed IPs for Atlas

  Shows the IP addresses and CIDR ranges allowed to reach your Atlas clusters.

  Try: “Which IPs can reach my clusters?”

  Network · atlas-inspect-access-list

• Lists triggered Atlas alerts

  Lists the alerts Atlas has raised for a project. It shows open alerts unless you ask for tracking or closed ones.

  Try: “Are there open alerts on my project?”

  Network · atlas-list-alerts

• Gets Atlas performance advice

  Returns suggested indexes, indexes to drop, schema suggestions and up to 50 recent slow queries.

  Try: “Why is my orders cluster slow? Check the performance advisor.”

  Network · atlas-get-performance-advisor

• Lists Atlas regions

  Lists the regions Atlas supports for a cloud provider.

  Try: “Which AWS regions can I use for a new cluster?”

  Network · atlas-get-regions

• Creates an Atlas project

  Creates a new Atlas project.

  Try: “Create an Atlas project called analytics.”

  Write · atlas-create-project

• Creates a free Atlas cluster

  Creates a free-tier Atlas cluster.

  Try: “Spin up a free cluster for testing in project analytics.”

  Write · atlas-create-free-cluster

• Creates a paid Atlas cluster

  Creates a dedicated cluster from M10 to M80 with compute and disk autoscaling. This spends money on your Atlas account.

  Try: “Create an M10 replica set cluster in us-east-1.”

  Write · atlas-create-cluster

• Creates an Atlas database user

  Creates a database user in an Atlas project with the roles you give it. It asks you to confirm by default.

  Try: “Create a read-only user for the analytics database.”

  Write · atlas-create-db-user

• Allows an IP to reach Atlas

  Adds IP addresses or CIDR ranges, or your current IP, to the Atlas access list. It asks you to confirm by default.

  Try: “Allow my current IP to access the cluster.”

  Write · atlas-create-access-list

• Loads sample data into a cluster

  Starts loading a MongoDB sample dataset into a cluster, or checks the progress of a load.

  Try: “Load the sample dataset into my test cluster.”

  Write · atlas-load-sample-dataset

• Pauses or resumes a cluster

  Pauses or resumes a dedicated (M10 and up) Atlas cluster.

  Try: “Pause the staging cluster tonight.”

  Write · atlas-pause-resume-cluster

• Upgrades or scales a cluster

  Upgrades a free or Flex cluster, or scales a dedicated cluster to another size, including autoscaling settings.

  Try: “Scale orders-prod up to M30.”

  Write · atlas-upgrade-cluster

• Inspects Atlas stream processing

  Lists and inspects Atlas Stream Processing workspaces, connections and processors, and helps debug a failing processor.

  Try: “Why is my Kafka processor failing?”

  Network · atlas-streams-discover

• Creates stream processing resources

  Creates Atlas Stream Processing workspaces, connections and processors.

  Try: “Set up a Kafka to Atlas pipeline in a new workspace.”

  Write · atlas-streams-build

• Changes stream processing resources

  Starts and stops processors, changes pipelines and updates workspace settings. It asks you to confirm by default.

  Try: “Stop the orders processor and change its pipeline.”

  Write · atlas-streams-manage

• Deletes stream processing resources

  Deletes workspaces, connections and processors after a basic safety check. It asks you to confirm by default.

  Try: “Remove my old streams workspace.”

  Delete · atlas-streams-teardown

• Lists local Atlas deployments

  Lists the MongoDB Atlas local deployments on your machine.

  Try: “What local Atlas deployments do I have?”

  Read · atlas-local-list-deployments

• Creates a local Atlas deployment

  Creates a MongoDB Atlas local deployment. It uses the preview image unless you name a tag.

  Try: “Create a local Atlas deployment for testing.”

  Write · atlas-local-create-deployment

• Connects to a local deployment

  Connects to a local Atlas deployment and returns a connection ID for the database tools.

  Try: “Connect to my local Atlas deployment.”

  Read · atlas-local-connect-deployment

• Deletes a local deployment

  Deletes a MongoDB Atlas local deployment.

  Try: “Delete the local deployment called dev-test.”

  Delete · atlas-local-delete-deployment

• Lists MongoDB docs sources

  Lists the data sources in the MongoDB Assistant knowledge base, so you can filter searches.

  Try: “Which sources can you search for MongoDB answers?”

  Network · list-knowledge-sources

• Searches MongoDB docs and guidance

  Searches the MongoDB Assistant knowledge base, which includes official docs and expert guidance, with optional source and version filters.

  Try: “How do I set up a TTL index? Check the MongoDB docs.”

  Network · search-knowledge

Watch out for

• It can delete data and whole databases

  Tools can delete documents, collections, indexes and databases. Run it with read-only mode, or keep the default confirmation prompts and use an app that supports them. github.com

• Atlas tools can create paid clusters

  The Atlas tools can create dedicated clusters, users and network access entries. Give the service account only the permissions you need. github.com

• No sign-in if you expose it to a network

  The README says the command-line server has no built-in authentication and is meant for one user on localhost. Do not bind it to a public address. github.com

• Confirmation needs app support

  Confirmation prompts work only in apps that support elicitation. Without it, rely on read-only mode. github.com

Security advisories