Local Secrets
@Hustada
Store and retrieve API keys and secrets locally for Claude Code. No cloud services, no .env files scattered across projects. Secrets are stored in a SQLite database on your machine and accessed via MCP tools. Supports add, get, list, search, update, and delete operations with cat
Overview
What is Local Secrets?
A local secrets manager for Claude Code that stores API keys and credentials securely on your machine using a SQLite database. It eliminates the need for cloud services or scattered .env files, designed for developers using Claude Code.
How to use Local Secrets?
Install and manage secrets via CLI with npx local-secrets-mcp init, npx local-secrets-mcp add <key> <value>, and npx local-secrets-mcp list. Secrets can also be accessed through MCP tools such as get_secret, add_secret, and search_secrets.
Key features of Local Secrets
- Store secrets in a local SQLite database
- Organize by category (api, auth, config, etc.)
- Search and filter secrets
- Get values formatted as environment variables
- Full CRUD operations via MCP tools
Use cases of Local Secrets
- Manage API keys for multiple projects in one place
- Avoid copying .env files between projects
- Organize credentials by category (e.g., API, auth)
- Securely retrieve secrets as environment variables
FAQ from Local Secrets
What is the difference from cloud-based secret managers?
Local Secrets keeps all data on your machine in a local SQLite database, with no cloud services involved.
Where are secrets stored?
Secrets are stored in a local SQLite database on your machine.
How do I access secrets?
Secrets can be accessed via CLI commands (e.g., npx local-secrets-mcp list) or through MCP tools like get_secret and list_secrets.
What runtime requirements does Local Secrets have?
It requires Node.js and npx to run the CLI and MCP tools.
Does Local Secrets support searching and filtering secrets?
Yes, you can search by key pattern and filter by category using MCP tools and CLI commands.
