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.
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 - Install the pinned directory interactively and retain its referenced files; inspect the source before granting tool access.
- 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.
https://github.com/mongodb/agent-skills/blob/c370a63b27075008a92134686b24af3817edeb00/skills/mongodb-natural-language-querying/SKILL.md
Supports: summary, review, install, access, limitations
- Pinned LICENSE ↗Checked
https://github.com/mongodb/agent-skills/blob/c370a63b27075008a92134686b24af3817edeb00/LICENSE
Supports: license
- Pinned README.md ↗Checked
https://github.com/mongodb/agent-skills/blob/c370a63b27075008a92134686b24af3817edeb00/README.md
Supports: summary, review, install, access, limitations
https://raw.githubusercontent.com/mongodb/agent-skills/c370a63b27075008a92134686b24af3817edeb00/skills/mongodb-natural-language-querying/SKILL.md
Supports: bestFor, review.notTested, review.reviewedAt