A Gemini CLI extension that provides MongoDB database and Atlas operations through the Model Context Protocol (MCP).
This extension wraps the official mongodb-mcp-server npm package, providing seamless installation for Gemini CLI users with automatic upstream updates.
git clone https://github.com/mongodb-partners/mongodb-gemini-extension.git
cd mongodb-gemini-extension
./deploy-mongodb-gemini-extension.shThe script checks prerequisites, installs the extension to ~/.gemini/extensions/mongodb/, and prompts for your MongoDB connection string.
Pass the URI directly for non-interactive use:
./deploy-mongodb-gemini-extension.sh --uri "mongodb+srv://user:pass@cluster.mongodb.net/mydb"gemini extensions install https://github.com/mongodb-partners/mongodb-gemini-extension.gitgit clone https://github.com/mongodb-partners/mongodb-gemini-extension.git
cd mongodb-gemini-extension
npm install
mkdir -p ~/.gemini/extensions
cp -R . ~/.gemini/extensions/mongodb-
Copy the configuration template:
cd ~/.gemini/extensions/mongodb cp mongo.config.json.example mongo.config.json
-
Add your MongoDB connection string to
mongo.config.json:{ "MONGODB_URI": "mongodb+srv://user:pass@cluster.mongodb.net/mydb" } -
Restart the Gemini CLI and verify:
/mcp /toolsThe MongoDB server and its tools appear in the output.
Security:
mongo.config.jsoncontains credentials and is excluded from version control via.gitignore. Do not commit this file.
- MongoDB CRUD — find, aggregate, insert, update, delete operations on collections
- Schema and index management — create/drop indexes, infer collection schemas, view stats
- Atlas cluster management — list orgs/projects, create clusters, manage users and access lists
- Atlas Search — create and list Atlas Search indexes
- Local deployments — create local Atlas deployments via Docker
- Data export — export query results to EJSON
- Read-only mode — restrict the extension to read operations
- Automatic updates — weekly CI checks for new
mongodb-mcp-serverreleases
All tools come from the upstream MongoDB MCP Server. The available set depends on the installed version.
| Tool | Description |
|---|---|
find |
Run a find query against a collection |
aggregate |
Run an aggregation pipeline |
count |
Count documents in a collection |
insert-one |
Insert a single document |
insert-many |
Insert multiple documents |
update-one |
Update a single document |
update-many |
Update multiple documents |
delete-one |
Delete a single document |
delete-many |
Delete multiple documents |
create-index |
Create an index on a collection |
drop-index |
Drop an index from a collection |
rename-collection |
Rename a collection |
drop-collection |
Drop a collection |
drop-database |
Drop a database |
list-databases |
List all databases |
list-collections |
List collections in a database |
collection-indexes |
List indexes on a collection |
collection-schema |
Infer the schema of a collection |
collection-storage-size |
Get collection size in MB |
db-stats |
Get database statistics |
export |
Export query results to EJSON |
explain |
Explain a query execution plan |
Requires MDB_MCP_API_CLIENT_ID and MDB_MCP_API_CLIENT_SECRET in your configuration. See the configuration reference.
| Tool | Description |
|---|---|
atlas-list-orgs |
List Atlas organizations |
atlas-list-projects |
List Atlas projects |
atlas-create-project |
Create an Atlas project |
atlas-list-clusters |
List Atlas clusters |
atlas-inspect-cluster |
Inspect a specific cluster |
atlas-create-free-cluster |
Create a free-tier cluster |
atlas-connect-cluster |
Connect to an Atlas cluster |
atlas-inspect-access-list |
Inspect IP/CIDR access list |
atlas-create-access-list |
Add IP/CIDR to access list |
atlas-list-db-users |
List database users |
atlas-create-db-user |
Create a database user |
atlas-list-alerts |
List project alerts |
| Tool | Description |
|---|---|
atlas-local-create-deployment |
Create a local Atlas deployment via Docker |
| Tool | Description |
|---|---|
create-search-index |
Create an Atlas Search index |
list-search-indexes |
List search indexes on a collection |
Run /tools in Gemini CLI to see the tools available with your installed version.
| Resource | Description |
|---|---|
config |
Server configuration (sensitive values redacted) |
debug |
Debugging info for connectivity issues |
exported-data |
Data exported via the export tool |
A GitHub Actions workflow (.github/workflows/sync-upstream.yml) runs weekly. When a new mongodb-mcp-server version is published, it creates a pull request with the updated dependency.
cd ~/.gemini/extensions/mongodb
npm install mongodb-mcp-server@latestCheck the installed version:
npm list mongodb-mcp-serverRestart the Gemini CLI after updating.
- Configuration reference — all config options and examples
- Architecture — how the extension works and why
- Developer guide — setup, testing, and contributing
- Troubleshooting — common errors and fixes
Apache-2.0 — see LICENSE.