Agent skill

MongoDB Query Client

by evolution-foundation in evolution-foundation/evo-nexus

Runs read-only MongoDB finds, aggregations and collection listings against databases named in your .env, choosing the connection by label or index.

Custom licenceAuto-check: notesDatabases

Install MongoDB Query Client

skills CLI
$ npx skills add evolution-foundation/evo-nexus --skill db-mongo -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install evolution-foundation/evo-nexus db-mongo --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/evolution-foundation/evo-nexus.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/db-mongo .claude/skills/db-mongo && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
db-mongo
GitHub stars
544
Token cost
~1.1k tokens
SKILL.md length
274 words
Files
2 (incl. scripts)
Skills in repo
117
Repo updated
First seen
Licence
Custom licence

At a glance

Runs read-only MongoDB finds, aggregations and collection listings against databases named in your .env, choosing the connection by label or index.

  • Works in 4 steps: accounts to confirm the connection label. → collections to see what's in there. → find or aggregate with the smallest… → …
  • Exploring the collections and documents in a MongoDB database
  • SKILL.md covers Setup — one-time, per database, Usage, Output shape and Guardrails, plus 4 more sections
  • Runs Python scripts from its folder; calls python3 and uv; needs DB_MONGO_2_PASSWORD

What it does

This skill queries MongoDB databases declared in `.env` as numbered `DB_MONGO_N_*` blocks. Each block needs a label and either a connection URI, recommended for Atlas or managed clusters, or separate host, port and credential values; the URI wins when both are present. A Python client, `scripts/db_client.py`, offers commands to list connections, ping one, find documents, run aggregation pipelines and list collections, and it prints each result as a single JSON line.

Guardrails make it safer to point at real data: connections are read-only by default, aggregation pipelines with `$out` or `$merge` are refused unless that block sets `ALLOW_WRITE=true`, results stop at `MAX_ROWS` (default 1000), timeouts apply, and the account listing strips passwords. Errors come back as named codes such as `connection_failed`, `invalid_pipeline` and `driver_missing`, the last meaning that `pymongo` is not installed.

When your agent uses it

  • Exploring the collections and documents in a MongoDB database
  • Running an aggregation to audit data, such as totals by product
  • Health-checking a configured MongoDB connection before querying

Example prompts

  • “Using the orders-dev connection, list the collections and show me ten customers.”
  • “Run an aggregation on analytics-prod that counts paid orders per product.”
  • “Ping the orders-dev MongoDB connection and tell me whether it is reachable.”

Requirements

  • Python with pymongo
  • A .env file with DB_MONGO_N_* connection blocks
  • Network access to the MongoDB server

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. accounts to confirm the connection label.
  2. collections to see what's in there.
  3. find or aggregate with the smallest query that answers the question.
  4. If a pipeline is expensive, ask the user whether to $limit earlier or add indexes before running.

What it can do on your machine

Read from SKILL.md and the folder at commit 7f5dd76. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • mongodb.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • DB_MONGO_2_PASSWORD

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

MongoDB Query Client loads about 1.1k tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 274 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~79
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:3
    : "Query MongoDB databases configured in .env (DB_MONGO_N_*). Use when the user asks to query, explore, or audit data in
  • NoteMentions a .env fileSKILL.md:19
    Query MongoDB databases declared in `.env`. Same numbered block pattern as every other `db-*` and `SOCIAL_*_N_*` integra
  • NoteMentions a .env fileSKILL.md:23
    Add a block to `.env` (gitignored). Two ways to define a connection:
  • NoteMentions a .env fileSKILL.md:111
    - **Credentials** never leave `.env`; `accounts` strips password before returning.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 274 words (~1,145 tokens).

“Query MongoDB databases declared in .env. Same numbered block pattern as every other db-* and SOCIAL_*_N_* integration.”

— opening of SKILL.md by evolution-foundation, Custom licence
name
db-mongo

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (scripts) in .claude/skills/db-mongo of evolution-foundation/evo-nexus.

  • SKILL.md
  • scripts/db_client.py

Open the folder on GitHubat commit 7f5dd76

Compare with similar skills

MongoDB Query Client next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

MongoDB Query Client compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
MongoDB Query Client this skillevolution-foundation/evo-nexus544—~1.1kAutomated safety check: NotesCustom licence
Whodbxiaoyuge886/aigc198—~894Automated safety check: PassMIT
Mongodb Guide Skilljiushiwon/wg-skills110—~1.7kAutomated safety check: PassApache-2.0
Mongodb BackupsTheDecipherist/claude-code-mastery-project-starter-kit338—~1.3kAutomated safety check: PassMIT
Mongodb Search And AImongodb/agent-skills1901 repos~1.7kAutomated safety check: PassApache-2.0
Fastapi Init Skilljiushiwon/wg-skills110—~1.8kAutomated safety check: NotesApache-2.0

Similar skills

  • Whodb

    xiaoyuge886/aigc

    Database operations including querying, schema exploration, and data analysis.

    198 GitHub stars~894 tokensUpdated 2 mo ago
    DatabasesAuto-check passed
  • Mongodb Guide Skill

    jiushiwon/wg-skills

    MongoDB 学习与选型指南。面向需要了解 MongoDB 的开发者,提供核心概念、安装部署、文档模型设计、CRUD、聚合查询、索引优化、与业务场景匹配推荐等(不含具体框架集成)。触发词:"MongoDB 学习"、"MongoDB 入门"、"MongoDB 选型"、"MongoDB 概念"、"MongoDB 安装"、"文档数据库"、"mongodb 设计"。

    110 GitHub stars~1.7k tokensUpdated 3 days ago
    DatabasesAuto-check passed
  • Mongodb Backups

    TheDecipherist/claude-code-mastery-project-starter-kit

    Production MongoDB backup and restore practices that the documentation gets wrong.

    338 GitHub stars~1.3k tokensUpdated 3 mo ago
    DatabasesAuto-check passed
  • Mongodb Search And AI

    mongodb/agent-skills

    Official

    Guides MongoDB users through implementing and optimizing Atlas Search (full-text), Vector Search (semantic), and Hybrid Search solutions.

    190 GitHub starsUsed in 1 repo~1.7k tokens
    DatabasesAuto-check passed
  • Fastapi Init Skill

    jiushiwon/wg-skills

    FastAPI 项目一键初始化技能。面向零基础小白,提供环境探测、自动安装、完整 Web 骨架生成、SSE 流式框架、JWT 鉴权、统一响应封装、文件上传接口、一键启动/重启脚本、Swagger 文档,内置 MySQL(默认)/ PostgreSQL / MongoDB 数据库选择。用户只需说"帮我搭一个 FastAPI 项目"即可一条命令完成从零到跑的完整链路。触发词:"FastAPI…

    110 GitHub stars~1.8k tokensUpdated 3 days ago
    Backend & APIsAuto-check: notes
  • Mongodb

    sickn33/agentic-awesome-skills

    Administer MongoDB databases. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~2.7k tokens
    DatabasesAuto-check: notes

More from evolution-foundation/evo-nexus

All 117 skills in this repo
  • AI Image Creator

    evolution-foundation/evo-nexus

    Generates PNG images through OpenRouter models, with transparent backgrounds and reference-image edits, and describes existing images with multimodal vision.

    544 GitHub stars~5.1k tokensUpdated 4 mo ago
    Auto-check: notes
  • MySQL and MariaDB Query Tool

    evolution-foundation/evo-nexus

    Queries MySQL or MariaDB databases declared in .env by label, read-only by default unless a connection explicitly allows writes.

    544 GitHub stars~1.9k tokensUpdated 4 mo ago
    Auto-check: notes
  • Postgres Query Client

    evolution-foundation/evo-nexus

    Runs read-only SQL queries and schema exploration against PostgreSQL databases declared in .env, chosen by label or index, with writes blocked unless a connection allows them.

    544 GitHub stars~1.8k tokensUpdated 4 mo ago
    Auto-check: notes
  • Redis Inspector

    evolution-foundation/evo-nexus

    Reads keys and server state from Redis instances configured in .env through a read-only Python client, choosing connections by label or index.

    544 GitHub stars~1.3k tokensUpdated 4 mo ago
    Auto-check: notes
  • Int Bling

    evolution-foundation/evo-nexus

    Bling ERP integration via API v3. An agent skill from evolution-foundation/evo-nexus.

    544 GitHub stars~2.5k tokensUpdated 4 mo ago
    Auto-check: notes
  • Int Evo CRM

    evolution-foundation/evo-nexus

    Query and manage Evo AI CRM data via REST API. An agent skill from evolution-foundation/evo-nexus.

    544 GitHub stars~2k tokensUpdated 4 mo ago
    Auto-check passed

Works with

Questions about MongoDB Query Client

What does MongoDB Query Client do?

Runs read-only MongoDB finds, aggregations and collection listings against databases named in your .env, choosing the connection by label or index. env` as numbered `DB_MONGO_N_*` blocks. Each block needs a label and either a connection URI, recommended for Atlas or managed clusters, or separate host, port and credential values; the URI wins when both are present.

When should I use MongoDB Query Client?

MongoDB Query Client fits situations like: exploring the collections and documents in a MongoDB database; running an aggregation to audit data, such as totals by product; health-checking a configured MongoDB connection before querying.

How do I install MongoDB Query Client in Claude Code?

Run `npx skills add evolution-foundation/evo-nexus --skill db-mongo -a claude-code`. Or copy the skill folder (.claude/skills/db-mongo in evolution-foundation/evo-nexus) into .claude/skills/db-mongo in your project. Claude Code loads it when a task matches its description.

How do I install MongoDB Query Client in Codex?

Run `npx skills add evolution-foundation/evo-nexus --skill db-mongo -a codex`. Or copy the skill folder (.claude/skills/db-mongo in evolution-foundation/evo-nexus) into .agents/skills/db-mongo in your project. Codex loads it when a task matches its description.

Can I use MongoDB Query Client in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add evolution-foundation/evo-nexus --skill db-mongo -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/db-mongo, .gemini/skills/db-mongo, .github/skills/db-mongo and .opencode/skills/db-mongo in your project.

What does MongoDB Query Client need to run?

Going by SKILL.md and its folder, MongoDB Query Client needs Python for the scripts in its folder, the command-line tools its instructions call (python3 and uv) and credentials named DB_MONGO_2_PASSWORD. Our summary lists: Python with pymongo; A .env file with DB_MONGO_N_* connection blocks; Network access to the MongoDB server.

Does MongoDB Query Client access the network?

SKILL.md names 1 domain. As links in the text: mongodb.com. This is read from the text; nothing was executed.

Is MongoDB Query Client safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does MongoDB Query Client use?

MongoDB Query Client has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does MongoDB Query Client use?

About 1.1k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to MongoDB Query Client?

Skills that share tags, products or a category with MongoDB Query Client: Whodb (xiaoyuge886/aigc, 198 stars), Mongodb Guide Skill (jiushiwon/wg-skills, 110 stars), Mongodb Backups (TheDecipherist/claude-code-mastery-project-starter-kit, 338 stars) and Mongodb Search And AI (mongodb/agent-skills, 190 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains MongoDB Query Client?

evolution-foundation (a GitHub organization) maintains it in evolution-foundation/evo-nexus, which has 544 GitHub stars. The repository holds 117 skills in this directory. The repository was last updated on May 13, 2026.

Source: evolution-foundation/evo-nexus on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.