Local Secrets
@Hustada
About Local Secrets
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
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"local-secrets": {
"command": "npx",
"args": [
"-y",
"local-secrets-mcp",
"serve"
]
}
}
}Tools
7Get a specific secret value by its key name
List all available secret keys (values are hidden)
Search for secrets by key name pattern
Get a secret formatted as an environment variable assignment
Add a new secret to the vault
Update an existing secret
Delete a secret from the vault
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.
Frequently asked questions
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.
Basic information
More Developer Tools MCP servers
SSH MCP Server
hypnosisSSH MCP server for AI agents: remote commands, file transfer, log search and server audits through OpenSSH.
Repo Test Architect
RepoAssayLocal-first, read-only MCP server for evidence-backed repository test architecture audits and test planning.
ZeroBeacon — 1000-Tool Collision-Proof Commerce Router
DavidFox998ZeroBeacon.ai — Collision-proof commerce router for AI agents. 1000 MCP tools: commerce, trust, billing, sovereign ID + everyday tools. LIVE.
Skycloak
Manage your Skycloak-hosted Keycloak: clusters, realms, apps, SSO and users, from any MCP client.
Vibgrate MCP
VibgrateQuery your team's drift, vulnerability, and migration data from any AI assistant. Vibgrate MCP connects Cursor, Claude, ChatGPT, Windsurf, or VS Code to Vibgrate Cloud: 51 tools for DriftScores, CVEs and EOL runtimes, up
Comments