MongoDB

mcp

A Model Context Protocol server to connect to MongoDB databases and MongoDB Atlas Clusters.

50K+

22 Tools

Packaged by

Requires Secrets

Add to Docker Desktop

Version 4.43 or later needs to be installed to add the server automatically

Overview Tools (22)Config Manual installation

Docker Hub⁠Github repository⁠

Use cases

Run an aggregation against a MongoDB collection

Describe the indexes for a collection

Describe the schema for a collection

Gets the size of the collection

Connect to a MongoDB instance. The config resource captures if the server is already connected to a MongoDB cluster. If the user has configured a connection string or has previously called the connect tool, a connection is already established and there's no need to call this tool unless the user has explicitly requested to switch to a new MongoDB cluster.

Gets the number of documents in a MongoDB collection using db.collection.count() and query as an optional filter parameter

Creates a new collection in a database. If the database doesn't exist, it will be created automatically.

Create an index for a collection

Returns statistics that reflect the use state of a single database

Removes all documents that match the filter from a MongoDB collection

View all

About

MongoDB MCP Server

A Model Context Protocol server to connect to MongoDB databases and MongoDB Atlas Clusters.

What is an MCP Server?⁠

MCP Info

Attribute	Details
Docker Image	mcp/mongodb⁠
Author	mongodb-js⁠
Repository	https://github.com/mongodb-js/mongodb-mcp-server⁠

Image Building Info

Attribute	Details
Dockerfile	https://github.com/mongodb-js/mongodb-mcp-server/blob/2c80bf4682ccd715e947abdd63e1140de95d7bec/Dockerfile⁠
Docker Image built by	Docker Inc.
Docker Scout Health Score
Verify Signature	`COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/mongodb --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub`
Licence	Apache License 2.0

Available Tools (22)

Tools provided by this Server	Short Description
`aggregate`	aggregate
`collection-indexes`	collection-indexes
`collection-schema`	collection-schema
`collection-storage-size`	collection-storage-size
`connect`	connect
`count`	count
`create-collection`	create-collection
`create-index`	create-index
`db-stats`	db-stats
`delete-many`	delete-many
`drop-collection`	drop-collection
`drop-database`	drop-database
`drop-index`	drop-index
`explain`	explain
`export`	export
`find`	find
`insert-many`	insert-many
`list-collections`	list-collections
`list-databases`	list-databases
`mongodb-logs`	mongodb-logs
`rename-collection`	rename-collection
`update-many`	update-many

Tools Details

Tool: `aggregate`

Run an aggregation against a MongoDB collection

Parameters	Type	Description
`collection`	`string`	Collection name
`database`	`string`	Database name
`pipeline`	`array`	An array of aggregation stages to execute. $vectorSearch can only appear as the first stage of the aggregation pipeline or as the first stage of a $unionWith subpipeline. When using $vectorSearch, unless the user explicitly asks for the embeddings, $unset any embedding field to avoid reaching context limits.
`responseBytesLimit`	`number`optional	The maximum number of bytes to return in the response. This value is capped by the server’s configured maxBytesPerQuery and cannot be exceeded. Note to LLM: If the entire aggregation result is required, use the "export" tool instead of increasing this limit.

This tool is read-only. It does not modify its environment.

Tool: `collection-indexes`

Describe the indexes for a collection

Parameters	Type	Description
`collection`	`string`	Collection name
`database`	`string`	Database name

This tool is read-only. It does not modify its environment.

Tool: `collection-schema`

Describe the schema for a collection

Parameters	Type	Description
`collection`	`string`	Collection name
`database`	`string`	Database name
`responseBytesLimit`	`number`optional	The maximum number of bytes to return in the response. This value is capped by the server’s configured maxBytesPerQuery and cannot be exceeded.
`sampleSize`	`number`optional	Number of documents to sample for schema inference

This tool is read-only. It does not modify its environment.

Tool: `collection-storage-size`

Gets the size of the collection

Parameters	Type	Description
`collection`	`string`	Collection name
`database`	`string`	Database name

This tool is read-only. It does not modify its environment.

Tool: `connect`

Parameters	Type	Description
`connectionString`	`string`	MongoDB connection string (in the mongodb:// or mongodb+srv:// format)

This tool is read-only. It does not modify its environment.

Tool: `count`

Gets the number of documents in a MongoDB collection using db.collection.count() and query as an optional filter parameter

Parameters	Type	Description
`collection`	`string`	Collection name
`database`	`string`	Database name
`query`	`object`optional	A filter/query parameter. Allows users to filter the documents to count. Matches the syntax of the filter argument of db.collection.count().

This tool is read-only. It does not modify its environment.

Tool: `create-collection`

Creates a new collection in a database. If the database doesn't exist, it will be created automatically.

Parameters	Type	Description
`collection`	`string`	Collection name
`database`	`string`	Database name

Tool: `create-index`

Create an index for a collection

Parameters	Type	Description
`collection`	`string`	Collection name
`database`	`string`	Database name
`definition`	`array`	The index definition. Use 'classic' for standard indexes and 'vectorSearch' for vector search indexes
`name`	`string`optional	The name of the index

Tool: `db-stats`

Returns statistics that reflect the use state of a single database

Parameters	Type	Description
`database`	`string`	Database name

This tool is read-only. It does not modify its environment.

Tool: `delete-many`

Removes all documents that match the filter from a MongoDB collection

Parameters	Type	Description
`collection`	`string`	Collection name
`database`	`string`	Database name
`filter`	`object`optional	The query filter, specifying the deletion criteria. Matches the syntax of the filter argument of db.collection.deleteMany()

This tool may perform destructive updates.

Tool: `drop-collection`

Removes a collection or view from the database. The method also removes any indexes associated with the dropped collection.

Parameters	Type	Description
`collection`	`string`	Collection name
`database`	`string`	Database name

This tool may perform destructive updates.

Tool: `drop-database`

Removes the specified database, deleting the associated data files

Parameters	Type	Description
`database`	`string`	Database name

This tool may perform destructive updates.

Tool: `drop-index`

Drop an index for the provided database and collection.

Parameters	Type	Description
`collection`	`string`	Collection name
`database`	`string`	Database name
`indexName`	`string`	The name of the index to be dropped.
`type`	`string`optional	The type of index to be deleted. Is always set to 'classic'.

This tool may perform destructive updates.

Tool: `explain`

Returns statistics describing the execution of the winning plan chosen by the query optimizer for the evaluated method

Parameters	Type	Description
`collection`	`string`	Collection name
`database`	`string`	Database name
`method`	`array`	The method and its arguments to run
`verbosity`	`string`optional	The verbosity of the explain plan, defaults to queryPlanner. If the user wants to know how fast is a query in execution time, use executionStats. It supports all verbosities as defined in the MongoDB Driver.

This tool is read-only. It does not modify its environment.

Tool: `export`

Export a query or aggregation results in the specified EJSON format.

Parameters	Type	Description
`collection`	`string`	Collection name
`database`	`string`	Database name
`exportTarget`	`array`	The export target along with its arguments.
`exportTitle`	`string`	A short description to uniquely identify the export.
`jsonExportFormat`	`string`optional	The format to be used when exporting collection data as EJSON with default being relaxed.
relaxed: A string format that emphasizes readability and interoperability at the expense of type preservation. That is, conversion from relaxed format to BSON can lose type information.
canonical: A string format that emphasizes type preservation at the expense of readability and interoperability. That is, conversion from canonical to BSON will generally preserve type information except in certain specific cases.

This tool is read-only. It does not modify its environment.

Tool: `find`

Run a find query against a MongoDB collection

Parameters	Type	Description
`collection`	`string`	Collection name
`database`	`string`	Database name
`filter`	`object`optional	The query filter, matching the syntax of the query argument of db.collection.find()
`limit`	`number`optional	The maximum number of documents to return
`projection`	`object`optional	The projection, matching the syntax of the projection argument of db.collection.find()
`responseBytesLimit`	`number`optional	The maximum number of bytes to return in the response. This value is capped by the server’s configured maxBytesPerQuery and cannot be exceeded. Note to LLM: If the entire query result is required, use the "export" tool instead of increasing this limit.
`sort`	`object`optional	A document, describing the sort order, matching the syntax of the sort argument of cursor.sort(). The keys of the object are the fields to sort on, while the values are the sort directions (1 for ascending, -1 for descending).

This tool is read-only. It does not modify its environment.

Tool: `insert-many`

Insert an array of documents into a MongoDB collection

Parameters	Type	Description
`collection`	`string`	Collection name
`database`	`string`	Database name
`documents`	`array`	The array of documents to insert, matching the syntax of the document argument of db.collection.insertMany()

Tool: `list-collections`

List all collections for a given database

Parameters	Type	Description
`database`	`string`	Database name

This tool is read-only. It does not modify its environment.

Tool: `list-databases`

List all databases for a MongoDB connection

Tool: `mongodb-logs`

Returns the most recent logged mongod events

Parameters	Type	Description
`limit`	`integer`optional	The maximum number of log entries to return.
`type`	`string`optional	The type of logs to return. Global returns all recent log entries, while startupWarnings returns only warnings and errors from when the process started.

This tool is read-only. It does not modify its environment.

Tool: `rename-collection`

Renames a collection in a MongoDB database

Parameters	Type	Description
`collection`	`string`	Collection name
`database`	`string`	Database name
`newName`	`string`	The new name for the collection
`dropTarget`	`boolean`optional	If true, drops the target collection if it exists

Tool: `update-many`

Updates all documents that match the specified filter for a collection

Parameters	Type	Description
`collection`	`string`	Collection name
`database`	`string`	Database name
`update`	`object`	An update document describing the modifications to apply using update operator expressions
`filter`	`object`optional	The selection criteria for the update, matching the syntax of the filter argument of db.collection.updateOne()
`upsert`	`boolean`optional	Controls whether to insert a new document if no documents match the filter

Use this MCP Server

{
  "mcpServers": {
    "mongodb": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MDB_MCP_CONNECTION_STRING",
        "mcp/mongodb"
      ],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "mongodb+srv://username:password@cluster.mongodb.net/myDatabase"
      }
    }
  }
}

Why is it safer to run MCP Servers with Docker?⁠

Manual installation

You can install the MCP server using:

Installation for

Related servers

Explore

Contribute

MongoDB

mcp

A Model Context Protocol server to connect to MongoDB databases and MongoDB Atlas Clusters.

50K+

22 Tools

Packaged by

Requires Secrets

Add to Docker Desktop

Version 4.43 or later needs to be installed to add the server automatically

Overview Tools (22)Config Manual installation

Docker Hub⁠Github repository⁠

Use cases

Run an aggregation against a MongoDB collection

Describe the indexes for a collection

Describe the schema for a collection

Gets the size of the collection

Gets the number of documents in a MongoDB collection using db.collection.count() and query as an optional filter parameter

Creates a new collection in a database. If the database doesn't exist, it will be created automatically.

Create an index for a collection

Returns statistics that reflect the use state of a single database

Removes all documents that match the filter from a MongoDB collection

View all

About