Mongo MCP

What QuantGeekDev/mongo-mcp MCP server does

QuantGeekDev/mongo-mcp MCP server connects an MCP client to a MongoDB database and exposes database operations as agent tools. It supports listing collections, inspecting collection schemas, filtering and projecting documents, and performing single-document inserts, updates, and deletions.

The server also covers index administration. An agent can list indexes for a collection, create an index, or remove one. Example tasks include finding users by location, filtering products by price and stock status, updating an order status, and removing matching documents.

How it works

The server receives a MongoDB connection URL as a command-line argument. The URL can include the host, port, database, username, password, and authentication source. MCP clients then expose the server’s tools to a language model, which can translate natural-language requests into MongoDB operations.

The available query and data tools are find, listCollections, insertOne, updateOne, and deleteOne. Index-related tools are createIndex, dropIndex, and indexes. The README describes these operations at the collection and document level; it does not document broader database administration features.

Setup and configuration

QuantGeekDev/mongo-mcp MCP server requires Node.js 18 or newer and npx. A MongoDB connection URL is also required. For Claude Desktop, add an mcpServers entry to the platform’s configuration file and set the command to npx, with mongo-mcp and the connection URL in the arguments.

On macOS, the documented Claude Desktop path is ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows, it is %APPDATA%/Claude/claude_desktop_config.json. The README also shows a local-development configuration that starts dist/index.js with a local MongoDB URL.

A Docker Compose sandbox is available for testing. It can start a local MongoDB instance, after which npm run seed creates sample Users, Products, and Orders collections. Docker and Docker Compose are prerequisites for this sandbox only, not for connecting to an existing MongoDB deployment.

Tools and capabilities

QuantGeekDev/mongo-mcp MCP server provides:

• Collection listing and schema inspection
• Filtered document queries with projection support
• Single-document insertion, updates, and deletion
• Collection index creation, removal, and listing
• Natural-language access through an MCP client such as Claude Desktop

Limitations and notes

The provided material documents Claude Desktop configuration but does not confirm compatibility with other named clients. Database credentials are supplied through the MongoDB connection URL, so configuration should protect that value. The examples include destructive actions such as deleting documents and dropping indexes; use appropriate database permissions and review agent-generated operations before applying them.

The README does not specify a read-only mode, transaction support, aggregation tooling, bulk operations, or deployment as a hosted remote service. QuantGeekDev/mongo-mcp MCP server is licensed under MIT and is presented as a Node.js project intended to run locally through an MCP client.