SecretButler 🗝️
A secure local MCP server for managing API keys with user approval
Overview
SecretButler provides a secure way to manage and share API keys with MCP clients like Claude Desktop and Cursor. It runs as a local server with a native GUI that requires explicit user approval before sharing any secrets.
✨ Features
- 🔒 Secure: Stores API keys locally in
~/.secretbutler.toml - 👤 User-controlled: GUI popup requires explicit approval for each request
- 🔌 MCP compatible: Works with any MCP client
- ⚙️ Easy setup: Simple TOML configuration
- 🍎 Native macOS: Uses native macOS GUI components
🚀 Installation
Add to your MCP client configuration:
{
"mcpServers": {
"SecretButler": {
"command": "uvx",
"args": ["secretbutler"],
"env": {
"CLIENT_NAME": "Claude"
}
}
}
}
⚙️ Configuration
On first run, SecretButler creates ~/.secretbutler.toml:
[secrets]
OPENAI_API_KEY = "sk-..."
ANTHROPIC_API_KEY = "sk-ant-..."
HF_API_KEY = "hf_..."
Simply edit this file to add your API keys.
🛠️ MCP Tools
| Tool | Description |
|---|---|
list_secrets() |
Returns available secret names (no approval needed) |
request_secrets(secret_names, client_name) |
Request specific secrets with user approval |
🔐 Security
- ✅ Secrets stored locally only
- ✅ No sharing without explicit approval
- ✅ Clear approval dialogs show requested secrets and client
- ✅ Foreground GUI prevents unauthorized access
📄 License
MIT License
Metadata
Release files for secretbutler 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| secretbutler-0.1.2.tar.gz | 1.1 MB | Without provenance | Details for secretbutler-0.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| secretbutler-0.1.2-py3-none-any.whl | Python 3 | none | any | Details for secretbutler-0.1.2-py3-none-any.whl |
Total release size: 1.1 MB
Release files / secretbutler-0.1.2.tar.gz
| Download URL | secretbutler-0.1.2.tar.gz |
|---|---|
| Size | 1.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f0ab41b0ba30e155a50bc4c534378cbfa2a8d1f2235bf4a62e2b01057546c6ec
|
|
BLAKE2b-256 checksum How to use checksums |
3817872c9417f330760b58d149edf820b1d78704aa1c0d9bc4ce6b040c8fa4d5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.10.15
|
Release files / secretbutler-0.1.2-py3-none-any.whl
| Download URL | secretbutler-0.1.2-py3-none-any.whl |
|---|---|
| Size | 5.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8886257b8f6ddfdb249f34c98899dae4d7798b4c4b61c1cf286f49c15e61776e
|
|
BLAKE2b-256 checksum How to use checksums |
6edaca731617e00c5d53f563f6359c9e2e37d680d4a059ff64e0c3b35865c71a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.10.15
|
Security for secretbutler 0.1.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.