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:

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

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

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