csvql-query

MCP server · npm · ★ 30 · graded 2026-10-20Source linked

Run SQL on CSV files in place. Query large CSV files fast with no import and no database. A CSV SQL engine in Zig with SIMD parsing, for Node and AI agents (MCP). Read only by design.

No outside reports on file

csvql-query connects to external service APIs; restrict its folder reach, network access, and credentials before installing.

Based on public adoption and transparency signals as of Oct 19, 2026. Our opinion, not a code audit or security guarantee.

Was this verdict for Csvql Query helpful?

What it can access

Local filesNo local folder access notedLOW
Command executionNo shell command runner notedLOW
Network reachConnects to outside service APINOTED
CredentialsRequires API key or tokenREVIEW
Package sourcenpm (csvql-query)PUBLIC

Inferred from this listing’s public package details and description. Check the project’s source before installing.

Install

npx -y csvql-query

All setup options ↓

Check this skill Watch it in my stack Compare Add to allowlist README badge View project

About Csvql Query

Csvql Query is an MCP server focused on Data & databases and Files & documents: Run SQL on CSV files in place. Query large CSV files fast with no import and no database. A CSV SQL engine in Zig with SIMD parsing, for Node and AI agents (MCP). Read only by design.

It is published on npm as csvql-query and hosted on GitHub at melihbirim/csvql (30 GitHub stars, 27 weekly npm downloads, last repository push on 2026-10-23). Based on its public metadata, its operational scope includes: connects to outside service api.

Setup

Check these steps against the project’s own instructions before running anything.

Run csvql-query with --ignore-scripts in claude_desktop_config.json or .cursor/mcp.json:

json

{
  "mcpServers": {
    "csvql-query": {
      "command": "npx",
      "args": ["-y", "--ignore-scripts", "csvql-query"]
    }
  }
}

Why this grade

DD — High risk signals

Signal-based grade (1/7 points): public source code. This reflects adoption and transparency, not a code review.

Popularity and upkeep

39/100

GitHub stars: 30
Weekly npm downloads: 524
Listing last refreshed: 2026-10-29

These are public popularity signals, not a maintenance check. Look at the repository’s commit history and open issues.

Security reports

No reports found for this package in our research (last checked 2026-10-29).

Check a specific version →

Risks to watch for

External API & account scope: Connects to third-party service APIs. Use a dedicated, least-privilege token scoped only to the workspaces or repositories this tool needs.
Dependency & version pinning: Distributed via npm (csvql-query). Pin an exact release version or commit SHA rather than floating tags so upstream updates are reviewed first.

How to lower the risk

Least-privilege permissions

Give it access only to the specific folders, accounts or projects it needs, never your whole drive or admin account.
Use a separate, limited API key or login just for this tool so you can switch it off without affecting anything else.

Network isolation

Run it on a work computer or sandbox account, not one holding personal or company-sensitive data.
If your IT team can, limit which websites and services it is allowed to contact.

Monitoring

Check its activity history or logs weekly at first, and look at what it changed or sent.
Turn on alerts for new logins or unusual usage on any account it connects to.

Red flags to watch for

It asks for more access than its job requires, or prompts you to paste passwords.
It suddenly updates with new owners, or starts contacting unfamiliar websites.

Questions

How do I install Csvql Query?

Run npx -y csvql-query in your terminal, or add the server entry to your claude_desktop_config.json or .cursor/mcp.json as shown in the Setup section on this page. Full setup docs and environment variables are in github.com/melihbirim/csvql.

Are there security reports about Csvql Query?

No reports found for this package in our research (last checked 2026-10-29). Csvql Query currently holds Grade D (High risk signals) based on public adoption and transparency signals. Key risk areas to watch include external api & account scope:, dependency & version pinning:.

Is Csvql Query actively maintained?

Csvql Query has 30 GitHub stars and 524 weekly npm downloads, with its latest repository commit pushed on 2026-10-23. Our directory data was last refreshed on 2026-10-29. Check recent commit activity, release tags, and open issues at github.com/melihbirim/csvql before pinning it in production.

What are alternatives to Csvql Query?

Compare Csvql Query side by side with similar MCP servers in the Related tools section on this page, or browse all MCP servers on AgentArmorHQ.

Maintain or use Csvql Query? Show its live grade in your GitHub README, docs site, or run a check from the terminal before you install.

AgentArmorHQ Risk Grade D for Csvql Query

GitHub README Markdown:

markdown

[![AgentArmorHQ Risk Grade for Csvql Query](https://agentarmorhq.com/api/badge/melihbirim-csvql)](https://agentarmorhq.com/skills/melihbirim-csvql)

HTML embed:

html

<a href="https://agentarmorhq.com/skills/melihbirim-csvql"><img src="https://agentarmorhq.com/api/badge/melihbirim-csvql" alt="AgentArmorHQ Risk Grade for Csvql Query" height="20" /></a>

Terminal check:

terminal

curl -fsSL https://agentarmorhq.com/api/cli | node --input-type=module - check "melihbirim-csvql"

Share with your security lead

Need sign-off to use csvql-query? Copy this note for Slack, a ticket or a pull request.

### AgentArmorHQ Security Review Memo: csvql-query
- **Listing URL:** https://agentarmorhq.com/skills/melihbirim-csvql
- **Type:** App connector
- **Risk Grade:** Grade D (High risk signals)
- **Outside Security Advisories on File:** 0
- **Public Adoption:** 30 GitHub stars, 524 weekly npm downloads

#### Permission & Blast-Radius Signals
- **Local files:** No local folder access noted
- **Command execution:** No shell command runner noted
- **Network reach:** Connects to outside service API
- **Credentials:** Requires API key or token
- **Package source:** npm (csvql-query)

#### Recommended Hardened Setup
- **Command:** `npx -y --ignore-scripts csvql-query`
- **Controls:** Pin an exact version in `.mcp.json`, scope access to a single workspace folder, and use a least-privilege read-only token where supported.

_Based on public adoption and transparency signals as of Oct 19, 2026. Our opinion, not a code audit or security guarantee._

Key facts

Type: App connector
Publisher: melihbirim
Source code: github.com/melihbirim/csvql
Install command: npm install csvql-query
Est. context load: ~900 tokens / turn (~5 tool schemas, 0.45% of 200k context)
Popularity: 30 GitHub stars, 524 weekly npm downloads
Last updated: 2026-10-29
Last graded: 2026-10-20

Community

Discussions for Csvql Query

Ask questions or share configuration tips. Governed by our Community Rules & Terms.

No posts match this filter yet.

Be the first to ask a question or share a working tip.

Was this listing for Csvql Query helpful?

Check before you install, in Claude

Your assistant answers Block, Review or No known issues for any package before it installs it.

Get this check inside Claude