Skip to main content
MCP server CX Codex

q-ring — Claude Code MCP server: what it does, how to install

q-ring is a Claude Code MCP server that keeps secrets in the operating system keychain and exposes them to coding agents. Environment-specific values resolve from project context.

AGPL-3.0 ★ 6 updated 2026-11-14

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env QRING_BACKEND=<QRING_BACKEND> --env QRING_FILE_PASSPHRASE=<QRING_FILE_PASSPHRASE> --env QRING_FILE_BACKEND_PATH=<QRING_FILE_BACKEND_PATH> --env QRING_CONFIG_DIR=<QRING_CONFIG_DIR> --transport stdio q-ring -- npx -y @i4ctime/q-ring
Open on GitHub

What q-ring does

q-ring stores API keys and other credentials in the native vault provided by macOS, Linux, or Windows, then exposes them to an agent through MCP. It includes 46 MCP tools for environment-aware values, linked secrets, generated credentials, and short-lived secret data.

Environment selection can use --env, QRING_ENV, NODE_ENV, Git branch rules, or .q-ring.json. Claude Code starts the package @i4ctime/q-ring through npx. A Docker container has no access to the host OS keychain, so that mode is limited to MCP access and ephemeral use rather than durable local storage.

What it helps with

  • keep API keys out of plain-text .env files
  • maintain separate secret values for dev, staging, and prod
  • propagate one secret across projects
  • expose credentials to an agent through MCP
  • create secrets that expire by time or read count

Example prompts for the agent

  • Store OPENAI_API_KEY and let the agent retrieve it through MCP.
  • Compare the secret states for staging and prod.
  • Promote DATABASE_URL from staging to prod with q-ring.

How to install q-ring

Platform CLI

claude mcp add --env QRING_BACKEND=<QRING_BACKEND> --env QRING_FILE_PASSPHRASE=<QRING_FILE_PASSPHRASE> --env QRING_FILE_BACKEND_PATH=<QRING_FILE_BACKEND_PATH> --env QRING_CONFIG_DIR=<QRING_CONFIG_DIR> --transport stdio q-ring -- npx -y @i4ctime/q-ring

Replace <…> with your own values

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about q-ring

How do I install q-ring in Claude Code?

Run claude mcp add q-ring -e QRING_FILE_PASSPHRASE=<QRING_FILE_PASSPHRASE> -- npx -y @i4ctime/q-ring.

What does q-ring do?

q-ring puts secrets in the operating system keychain and gives coding agents MCP tools for retrieving, generating, sharing, and resolving credentials by environment.

What does q-ring require to work?

The installation command uses npx. Durable local storage relies on the native keychain on macOS, Linux, or Windows; the Docker mode cannot access that keychain.

Similar MCP servers

MCP servers catalog →
oura-ring-mcp mitchhankins01 Brings Oura Ring biometrics directly into AI chats. Good for tracking sleep stages, readiness scores, and daily stress trends without manual exports. CX Codex +1 ★ 37repo stars tree-ring-memory TerminallyLazy tree-ring-memory is a Claude Code hook that loads saved context when a session starts and checks memory when it ends. It also runs at subagent start and stop. CX Codex ★ 1,596repo stars Context7 upstash Context7 brings current, version-aware library docs and code examples into an AI coding agent. Use it when generated answers rely on stale or invented APIs. CX Codex +1 5,563installs Search Google Flights punitarani The Search Google Flights MCP server looks up flights on a chosen date or scans a date range to find the cheapest days to fly. CX Codex +1 2,595installs Math-MCP EthanHenrickson Math-MCP provides arithmetic, statistical, and trigonometric operations for language models. Useful when you need reliable calculations without hallucinations. CX Codex +1 5,958installs pipeworx gateway pipeworx pipeworx gateway connects AI agents to 250+ live data sources without API keys, covering SEC filings, economic metrics, and weather. Includes cross-session memory. CX Codex +1 419,019installs SparkForge henry-ships SparkForge — an MCP server with tools for screenshots, page scraping, OCR and format conversion. It also generates images and looks up crypto data. CX Codex +1 219,896installs OpenWebSearch aas-ee The OpenWebSearch MCP server searches several engines and retrieves page content. It fits agent workflows that need current web data without API keys. CX Codex +1 494installs

Project sponsors

Companies that keep this analytics open