Repolode
mongodb-js

mongodb-js/mongodb-mcp-server

An MCP server that lets AI agents query and manage MongoDB databases and MongoDB Atlas clusters through a set of tools.

Stars
1,149
Forks
297
Open issues
29
Last commit
2 hours ago

What is it?

MongoDB MCP Server implements the Model Context Protocol so AI clients such as Cursor, Claude Desktop and VS Code can connect to a MongoDB deployment and run operations on it. It works with any MongoDB connection string, whether the database is local or hosted on Atlas, and it can run in read-only mode to prevent writes.

The server exposes tools for common database work, including find, aggregate, count, index inspection, schema description, export and collection or database management. When Atlas API service account credentials are configured, it also offers tools to inspect and create clusters, manage access lists and database users, pause or resume clusters, load sample datasets and manage Atlas Stream Processing resources.

It can be installed through npx or Docker, and the README documents setup for several MCP clients along with configuration via environment variables or command-line flags. Tool calls that delete data or change access can be set to require user confirmation.

Key features

  • 01Query, aggregate and inspect collections, indexes and schemas through MCP tools.
  • 02Read-only mode available to block write operations.
  • 03Works with local MongoDB and Atlas clusters via connection string.
  • 04Optional Atlas API tools for cluster, access list and database user management.
  • 05Installable via npx or Docker with configuration through environment variables or flags.

Use cases

  • Letting an AI coding assistant explore a development MongoDB database while writing queries.
  • Asking an AI agent to summarize collection schemas and index usage in a read-only setting.
  • Managing Atlas clusters and access lists from an AI chat client with service account credentials.

Quick start

  1. 1

    Run the interactive setup script

    npx -y mongodb-mcp-server@latest setup
  2. 2

    Or run the server directly with read-only mode

    npx -y mongodb-mcp-server@latest --readOnly

Things to know

  • Requires Node.js 22.13 or later.
  • Atlas tools need Atlas Service Account API credentials.

In collections

Topics

FAQ

What is mongodb-mcp-server?
An MCP server that lets AI agents query and manage MongoDB databases and MongoDB Atlas clusters through a set of tools. MongoDB MCP Server implements the Model Context Protocol so AI clients such as Cursor, Claude Desktop and VS Code can connect to a MongoDB deployment and run operations on it. It works with any MongoDB connection string, whether the database is local or hosted on Atlas, and it can run in read-only mode to prevent writes.
Is mongodb-mcp-server free to use? What license does it have?
mongodb-mcp-server is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is mongodb-mcp-server still maintained?
Actively maintained. The last commit to mongodb-mcp-server was on Oct 22, 2026.
What can I use mongodb-mcp-server for?
Letting an AI coding assistant explore a development MongoDB database while writing queries. Asking an AI agent to summarize collection schemas and index usage in a read-only setting. Managing Atlas clusters and access lists from an AI chat client with service account credentials.
How do I install mongodb-mcp-server?
Run the interactive setup script: npx -y mongodb-mcp-server@latest setup Or run the server directly with read-only mode: npx -y mongodb-mcp-server@latest --readOnly
Where can I get mongodb-mcp-server?
The source code and installation instructions are on GitHub: https://github.com/mongodb-js/mongodb-mcp-server

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects