Setup reference.
The homepage has the setup command and agent-specific guidance. Use this reference for configuration scope, environment requirements, and troubleshooting.
npx -y queryio setupNode.js 20+ required · PostgreSQL only · No global install needed
Configuration scope and file changes
Run setup from your application repository. Choose one or more of Claude Code, Codex, and Cursor. Project scope is the default; global scope applies across projects and requires an extra confirmation.
Setup previews the entries it will write, preserves other MCP servers and settings, and backs up files it modifies. It asks before replacing an existing QueryIO entry. Matching configuration is left unchanged.
Keep your connection in your environment.
Set QUERYIO_DATABASE_URL in the environment that starts your agent, using an existing PostgreSQL database and a dedicated role with narrow read permissions. Start your agent from that terminal so it can pass the variable to QueryIO. An editor opened from the Dock, Start menu, or an existing window may not inherit it.
This website never requests, collects, or stores connection strings. The wizard does not ask for your connection string, save it, or load .env files. It does not provision a database or provide secure credential storage.
When the variable is available, setup checks database connectivity and role privileges, then starts QueryIO to list its tools. Missing or invalid credentials leave setup incomplete. To check the connection after setting the variable, run npx -y queryio check in that terminal.
QueryIO is not a security sandbox. Returned records enter your agent’s context, and redaction can be bypassed by aliases or expressions. Read the security and resource-limit guidance before connecting sensitive data.
Seeing an older npm release?
QueryIO 0.2.1 includes the setup wizard and agent preselection flags. If npm serves an older version, retry with npx -y queryio@0.2.1 setup. If that version is not available from your registry, use the manual configuration docs or retry once it is available.