MongoDB

mcp

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

6.7K

20 Tools

Signed

Built by Docker

Requires Secrets

Add to Docker Desktop

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

Overview Tools (20)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

Removes a collection or view from the database. The method also removes any indexes associated with the dropped 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?⁠

Characteristics

Attribute	Details
Docker Image	mcp/mongodb⁠
Author	mongodb-js⁠
Repository	https://github.com/mongodb-js/mongodb-mcp-server⁠
Dockerfile	https://github.com/mongodb-js/mongodb-mcp-server/blob/main/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 (20)

Tools provided by this Server	Short Description
`aggregate`	aggregate
`collection-indexes`	collection-indexes
`collection-schema`	collection-schema
`collection-storage-size`	collection-storage-size
`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
`explain`	explain
`find`	find
`insert-many`	insert-many
`list-collections`	list-collections
`list-databases`	list-databases
`mongodb-logs`	mongodb-logs
`rename-collection`	rename-collection
`switch-connection`	switch-connection
`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

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

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: 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
`keys`	`object`	The index definition
`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: 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

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()
`sort`	`object`optional	A document, describing the sort order, matching the syntax of the sort argument of cursor.sort()

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: switch-connection

Switch to a different MongoDB connection. 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 instance.

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

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

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:[email protected]/myDatabase"
      }
    }
  }
}

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

Manual installation

You can install the MCP server using:

Installation for

MongoDB

MongoDB MCP Server

Characteristics

Available Tools (20)

Tools Details

Use this MCP Server

Related servers

Couchbase

Neon

Astra DB

Atlan MCP Server