keyward
Local encrypted vault that lets AI coding agents request API keys by name, with your
- Pricing
- Open source
- Platforms
- CLI, macOS, Linux
- Version
- 0.1.1
- Listing updated
- today
Similar MCP servers
About keyward
keyward is an open-source MCP server for security. It is available on CLI, macOS, Linux and Windows.
The README says keyward stores API keys in one local encrypted vault and lets an AI tool ask for a key by name. Each request triggers a native OS approval dialog that the agent cannot click through, and only the approved key is written into the target project file. The model receives a confirmation rather than the secret value.
The vault is an age-encrypted file in the home directory, with its master key held in the operating system keystore such as macOS Keychain, Windows Credential Manager or libsecret on Linux. An audit log records tool, key, namespace, target and decision, but never the value. Keys can also be imported from existing .env files across a projects folder.
It is aimed at developers who use Claude Code, Cursor, Gemini CLI or other MCP-capable tools and want to stop pasting credentials into chats or re-entering them in every session. It runs as a stdio MCP server exposing list_keys and request_key, alongside a keyward command-line tool.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- list_keys
- Returns key names only, never values.
- request_key
- Requests approval to inject a named key into a target file and returns a confirmation.
What it does
- Encrypted local vault
- Keys are stored in an age-encrypted file with the master key kept in the OS keystore.
- Per-request approval
- Each key request opens a native OS dialog that the agent cannot approve on its own.
- Value-free responses
- The MCP tools return names and confirmations, so secret values stay out of model context.
- Audit logging
- Each decision is logged with tool, key, namespace and target, but never the value.
- Import from .env files
- Existing keys scattered across .env files can be gathered into the vault in one step.
- Stdio MCP server
- Runs locally over stdio and registers with Claude Code and other MCP clients via a command and args.
Good for
- Letting a coding agent use a Stripe or other API key without pasting it into chat
- Reusing the same keys across multiple projects, IDEs and sessions
- Replacing scattered .env files with one encrypted source of truth
- Approving or denying each secret access an AI agent makes
Pricing
Open source
Free and open source under MIT; runs locally.
keyward FAQ
Does the AI model ever see the key value?
According to the README, request_key injects the value into a target file and returns only a confirmation, so the value is not returned to the agent.
Can the agent approve its own key requests?
The README says the approval dialog is rendered by keyward outside the agent's stream, and that all dialog backends fail closed, so errors or cancellations count as denial.
How is the vault encrypted?
The vault is encrypted at rest with age, and the master key is stored in the OS keystore rather than on disk in plaintext.
What is the license?
The README states the project is released under the MIT license.
Is keyward free?
Yes. keyward is open source, so you can use and self-host it for free.
What are the best alternatives to keyward?
The closest alternatives to keyward are Keyfold, q-ring, Keysrs, keygrant and keyshroud.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.