Connect Claude to MongoDB with Mongoose

MongoDB Mongoose MCP is an MCP server that lets Claude interact directly with MongoDB databases, with optional Mongoose schema support layered on top for data validation and hooks. It cleanly separates schema-based operations from schemaless ones, so you can use it against a database with defined Mongoose schemas or a plain, schema-free MongoDB collection.

Use it when you want Claude to query, aggregate, insert, update, or manage MongoDB collections conversationally, for example "Show me all users in my database who are older than 30" or "Create an index on the email field of the users collection." It requires Node.js 18+ and a running MongoDB instance, connected via MONGODB_URI. Deletes are implemented as soft deletes rather than hard removal, marking documents rather than destroying them, which matters if you're building on top of this for anything where accidental data loss is a real risk. Mongoose schema support is optional: point SCHEMA_PATH at a directory of schema files, named to match their collection, to get validation and hooks, or skip it entirely for schemaless operation.

Query tools include find, with filtering and projection, listCollections, insertOne, updateOne, deleteOne, a soft delete rather than a hard removal, count, and aggregate for pipeline-based queries. Index tools include createIndex, dropIndex, and indexes to list a collection's current indexes. Under the hood, the server uses the MongoDB native driver for direct database operations and layers in Mongoose for schema-based operations whenever a matching schema file is found under SCHEMA_PATH. A schema file is simply a default-exported plain object describing fields and their types, such as name, email, age, and the createdAt timestamp, rather than a full Mongoose model definition.

In Claude Desktop's claude_desktop_config.json, Settings, Developer, Edit config:

{
  "mcpServers": {
    "mongodb-mongoose": {
      "command": "npx",
      "args": [
        "-y", 
        "mongo-mongoose-mcp",
      ],
      "env": {
        "MONGODB_URI": "<your mongodb uri>",
        "SCHEMA_PATH" : "<path to the root folder of all your mongoose schema objects>"
      }
    }
  }
}

To build from source instead: clone the repository, npm install, npm run build, and test it with the MCP Inspector via npx @modelcontextprotocol/inspector node dist/index.js.

Developers who want Claude to query and manage a MongoDB database conversationally, with optional Mongoose-backed validation for collections that need it, instead of writing MongoDB queries by hand. It is released under the MIT License. A typical Mongoose schema file, placed under SCHEMA_PATH and named after its collection, looks like a plain object defining fields such as name, email, age, createdAt, and the isDeleted/deletedAt pair the server's soft-delete behavior relies on.