← Explore all skills

DATABASE ENGINEERING / mongodb

MongoDB Natural Language Queries

Translate questions into MongoDB read queries using inspected schema, indexes and bounded samples.

“Generate read-only MongoDB queries (find) or aggregation pipelines using natural language, with collection schema context and sample documents. Use this skill whenever the user asks to write, create, or generate MongoDB queries, wants to filter/query/aggregate data in MongoDB, asks "how do I query...", needs help with query syntax, or discusses finding/filtering/grouping MongoDB documents. Also use for translating SQL-like requests to MongoDB syntax. Does NOT handle Atlas Search ($search operator), vector/semantic search ($vectorSearch operator), fuzzy matching, autocomplete indexes, or relevance scoring - use search-and-ai for those. Does NOT analyze or optimize existing queries - use mongodb-query-optimizer for that. Does NOT handle aggregation pipelines that involve write operations. Requires MongoDB MCP server.”

01 / THE REASONING

Why this made the selection.

  • The workflow prefers find for simple retrieval, reserves aggregation for transformations/grouping, and explicitly excludes write pipelines and Atlas Search.
  • Create a grouped reporting pipeline with correct field names and index-aware filters.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • skills/mongodb-natural-language-querying/SKILL.md
  • LICENSE
  • README.md

Our findings

  • The workflow prefers find for simple retrieval, reserves aggregation for transformations/grouping, and explicitly excludes write pipelines and Atlas Search.

Not established by this review

  • Third-party instructions and helpers were not executed; service access, host compatibility and outcomes remain untested.
  • Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Add a skill to your workflow.

Upstream setup instructions ↗

DOCUMENTED COMMAND

npx skills add mongodb/agent-skills/skills/mongodb-natural-language-querying

Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.

Optional: install the reviewed revision

Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.

npx skills add https://github.com/mongodb/agent-skills/tree/c370a63b27075008a92134686b24af3817edeb00/skills/mongodb-natural-language-querying
  1. Install the pinned directory interactively and retain its referenced files; inspect the source before granting tool access.
  2. Select database/collection, inspect indexes and schema, obtain only necessary redacted samples, then review query semantics and output fields before execution.

Before you start

  • MongoDB MCP with read access and a known collection; a driver/runtime only for application integration

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://github.com/mongodb/agent-skills/blob/c370a63b27075008a92134686b24af3817edeb00/skills/mongodb-natural-language-querying/SKILL.md

    Supports: summary, review, install, access, limitations

  2. Pinned LICENSE ↗Checked

    https://github.com/mongodb/agent-skills/blob/c370a63b27075008a92134686b24af3817edeb00/LICENSE

    Supports: license

  3. Pinned README.md ↗Checked

    https://github.com/mongodb/agent-skills/blob/c370a63b27075008a92134686b24af3817edeb00/README.md

    Supports: summary, review, install, access, limitations

  4. https://raw.githubusercontent.com/mongodb/agent-skills/c370a63b27075008a92134686b24af3817edeb00/skills/mongodb-natural-language-querying/SKILL.md

    Supports: bestFor, review.notTested, review.reviewedAt

Evidence & Ask