PluginInstalls cleanly

Work with a MongoDB database

MongoDB Agent Skills

Official MongoDB skills and connector that help your assistant design a database, write and speed up queries, and explore your MongoDB Atlas data.

Works with
Claude Code, Codex CLI
Good for
Build an app

What it does

MongoDB is a popular database: the place where an app keeps its users, orders or posts. MongoDB Atlas is MongoDB's hosted version, so you do not run the database yourself.

This official package gives your assistant two things:

  • Skills — short guides from MongoDB on how to design how data is stored (the "schema"), write queries from plain language, make slow queries faster, set up search, and connect safely.
  • A connector (MCP server) that lets the assistant look at your real Atlas data after you sign in.

There are two plugins, both in Anthropic's official plugin directory. The version there is 1.2.1.

  • mongodb-atlas uses MongoDB's hosted connector at mcp.mongodb.com. You sign in to Atlas in your browser. Your queries and the data they return pass through MongoDB. It suits Atlas users and is the plugin this page installs.
  • mongodb runs the connector on your computer with npx for your own MongoDB server. You give it a connection string. That local server sends usage data to MongoDB by default. Set MDB_MCP_TELEMETRY=disabled or DO_NOT_TRACK=1 to stop it. The README sends these users to a separate setup page.

Once you sign in, the connector can do more than read. The plugin description says it can manage collections, database users, clusters and network access. Read each change before you approve it, and try it on a test database first.

One skill, mongodb-natural-language-querying, writes read-only queries. While it runs, it pre-approves every tool of a connector named mongodb. The plugins' own connectors get longer names, so this matters mainly if you added a server named mongodb yourself (our reading, not tested).

The plugins add no hooks.

Who it is for

People who build an app on MongoDB, or want to start one, and want the assistant to follow MongoDB's own advice.

Example prompts

  • "Show me which collections are in my Atlas database and what a typical document looks like."
  • "Design a schema for a small online shop with customers, orders and products."
  • "This query is slow. Find out why and suggest an index."
  • "Write a query that lists last week's orders over 100 euros."
  • "Help me set up search on my product names."

How to install

/plugin install mongodb-atlas@claude-plugins-official
/reload-plugins

How to use it

Ask: Look at my Atlas database and suggest a better schema for my orders collection. After installing the plugin, run /reload-plugins, then sign in to Atlas when asked.

Other assistants

Codex (from the README): type /plugins, find mongodb-atlas and install it.

Skills only, without a connector, for any assistant (from the README):

npx skills add mongodb/agent-skills

To add a connector later, the README gives npx "mongodb-mcp-server@latest" setup. It always fetches the newest version.

We have not tested the Codex route.

Check it works

  1. After the install, run /reload-plugins, as the README says.
  2. Ask for something that needs your data, for example "List my Atlas clusters". The first time, a browser window asks you to sign in to MongoDB Atlas (README, Authentication).
  3. Type / and look for the skills, for example /mongodb-atlas:mongodb-schema-design.

Common problems

  • The plugin is installed but nothing happens — it was not activated yet — run /reload-plugins after the install prompts, as the README says.
  • You use your own MongoDB server, not Atlas — the mongodb-atlas plugin only connects to Atlas — install the mongodb plugin (/plugin install mongodb@claude-plugins-official) and follow the Community and Enterprise setup page.
  • The plugin does not load in Claude Code — follow the plugin troubleshooting steps in the Claude Code docs.

What to watch out for

  • Sends data to MongoDB: the mongodb-atlas plugin connects to MongoDB's hosted Atlas MCP server after a browser sign-in, so your queries and the data they return pass through MongoDB (README)
  • Can change your database: the plugin description says it can manage collections, database users, clusters and network access; approve every change yourself and use a test database first
  • The other plugin, mongodb, runs mongodb-mcp-server with npx on your computer; that server sends usage data to MongoDB unless you set MDB_MCP_TELEMETRY=disabled or DO_NOT_TRACK=1 (mongodb-mcp-server README)
  • The query-writing skill pre-approves every tool of a connector named mongodb while it runs (allowed-tools: mcp__mongodb__*); this matters if you added the server yourself under that name (our reading, not tested)

Licence and author

Licence
Apache-2.0
Author
MongoDB
Source code
github.com/mongodb/agent-skills

How we tested it

We installed it on an empty test computer on 22 Oct 2026. Installed and started in a clean test system. Not yet used in a real AI session.

Test level

Not run: "/plugin install mongodb-atlas" (not a form the sandbox runs). No Atlas sign-in, so the connector was not used. Not yet used on real work.

Technical details of the test
Date
22 Oct 2026
Method
Intake sandbox run on 2026-10-22 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files, ran "npx -y skills --help".

Checked again on 22 Oct 2026

Alternatives

  • pg-aiguide — the same kind of help for PostgreSQL databases.
  • duckdb-skills — analyse data files on your own computer, no server needed.
  • Baserow MCP — a spreadsheet-style database that you edit in the browser.

FAQ

Do I need a MongoDB account? For the mongodb-atlas plugin, yes (Atlas). The skills alone work without one.

Can it delete my data? The connector can change databases and Atlas settings once you sign in. Read every change before you approve it.

Does it work in Codex? Yes. The README says to open /plugins in Codex, find mongodb-atlas and install it.

Is it free? The plugin and skills are free (Apache-2.0). Atlas has a free plan (MongoDB's pricing page: $0, 512 MB of storage) and paid plans.

Sources

  • github.com/mongodb/agent-skills
  • github.com/mongodb/agent-skills/blob/main/plugins/mongodb-atlas/.claude-plugin/plugin.json
  • github.com/mongodb/agent-skills/blob/main/README.community.md
  • github.com/mongodb/agent-skills/blob/main/skills/mongodb-natural-language-querying/SKILL.md
  • github.com/mongodb-js/mongodb-mcp-server
  • mongodb.com/docs/agent-skills/
  • mongodb.com/pricing