Mongo Mongoose MCP

What is Mongo Mongoose MCP about?

Mongo Mongoose MCP provides a Model Context Protocol server that lets Claude interact directly with MongoDB collections. It can operate in a schemaless mode using the native MongoDB driver or switch to Mongoose‑based schemas when a SCHEMA_PATH is supplied, allowing data validation and lifecycle hooks.

How to use Mongo Mongoose MCP?

1. Add to Claude Desktop – edit claude_desktop_config.json and add a server entry:

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

2. Run the server – Claude will start the MCP via the npx command.
3. From source – clone the repo, npm install, npm run build, then test with:

npx @modelcontextprotocol/inspector node dist/index.js

4. Use natural language – ask Claude to find, insertOne, updateOne, deleteOne, aggregate, etc., and the MCP translates the request to MongoDB operations.

Key features of Mongo Mongoose MCP

• Direct query, aggregation, insert, update and soft‑delete commands.
• Optional Mongoose schema loading for validation, defaults and hooks.
• Index management (createIndex, dropIndex, indexes).
• Collection discovery with listCollections.
• Simple integration via npx – no global install required.
• Built‑in soft‑delete fields (isDeleted, deletedAt).

Use cases of Mongo Mongoose MCP

• Allow non‑technical users to explore and modify data in a MongoDB database through natural language.
• Provide a secure, schema‑aware API layer for internal tools that need CRUD capabilities without writing custom backend code.
• Rapid prototyping of data‑driven features in Claude‑powered assistants.
• Automated reporting or analytics where Claude can run aggregation pipelines on demand.

FAQ from the Mongo Mongoose MCP

Q: Do I need Mongoose schemas? A: No. If SCHEMA_PATH is omitted the server works with the native driver in a schemaless mode.

Q: How does soft delete work? A: The deleteOne command sets isDeleted to true and records deletedAt; the document remains in the collection.

Q: Which Node version is required? A: Node.js v18 or higher.

Q: Can I use this outside Claude? A: Yes. The MCP server exposes a standard protocol that can be called by any client that implements the Model Context Protocol.

Q: How are indexes created? A: Use the createIndex command with collection name, field specification and optional options.

MongoDB Mongoose MCP

An MCP (Model Context Protocol) server that enables Claude to interact with MongoDB databases, with optional Mongoose schema support.

Features

• Query, aggregation, insert, update, and manage MongoDB collections directly from Claude
• Optional Mongoose schema support for data validation and hooks
• Soft delete implementation for document safety
• Clean separation between schema-based and schemaless operations

Prerequisites

• Node.js (v18 or higher)
• MongoDB

Integrating with Claude Desktop

To add the MCP server to Claude Desktop:

1. Go to Settings > Developer > Edit config
2. Add the following to your claude_desktop_config.json file:

{
  "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>"
      }
    }
  }
}

Available MCP Commands

When integrated with Claude, the following commands become available:

Query Tools

• find: Query documents with filtering and projection
• listCollections: List available collections
• insertOne: Insert a single document
• updateOne: Update a single document
• deleteOne: Soft delete a single document
• count: Count documents with filtering
• aggregate: Query documents with aggregation pipeline

Index Tools

• createIndex: Create a new index
• dropIndex: Remove an index
• indexes: List indexes for a collection

Example Usage

Once integrated with Claude Desktop, you can use natural language to interact with your MongoDB database:

• "Show me all users in my database who are older than 30"
• "Insert a new product with name 'Widget X', price $29.99, and category 'Electronics'"
• "Count all completed orders from the past week"
• "Create an index on the email field of the users collection"

For Developers

Building from Source

# Clone the repository
git clone https://github.com/nabid-pf/mongo-mongoose-mcp.git
cd mongo-mongoose-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Test with the MCP inspector
npx @modelcontextprotocol/inspector node dist/index.js

Creating Mongoose Schemas

Place your Mongoose schema object files in the a directory and specify that path in SCHEMA_PATH var Make sure file names reflect the collection name

// models/users.js (for users collection)
export default {
  name: { type: String, required: true },
  email: { type: String, required: true, unique: true },
  age: Number,
  createdAt: { type: Date, default: Date.now },
  isDeleted: { type: Boolean, default: false },
  deletedAt: Date
};

How It Works

This project uses:

• MongoDB native driver for direct database operations
• Mongoose for schema-based operations when schemas are available
• The Model Context Protocol (MCP) to communicate with Claude

License

MIT