Skip to main content

SecretButler 🗝️

A secure local MCP server for managing API keys with user approval

Install MCP Server

SecretButler Logo

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.

SecretButler Example

✨ 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)

Source distribution for secretbutler 0.1.2
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)

Table of built distributions (wheels) for secretbutler 0.1.2
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page