Secrets

MCP server that gives Claude Code access to your personal secrets and notes stored in a simple Markdown file (~/.secrets.md).

Install

npx secrets-mcp setup

This will:

1. Create ~/.secrets.md if it doesn't exist
2. Create a desktop shortcut to open it
3. Register the MCP server globally in Claude Code

Usage

After setup, Claude Code can access your secrets from any project using these tools:

Tool	Description
list_sections	List all section titles
get_section	Get a section by title
search_secrets	Search by keyword
upsert_section	Add or update a section
delete_section	Delete a section

Edit your secrets

Double-click "My Secrets.bat" on your desktop, or open ~/.secrets.md in any editor.

File format

Your ~/.secrets.md is standard Markdown with sections:

# My Secrets

## AWS

- Access Key: AKIA...
- Secret Key: wJalr...
- Region: us-east-1

## Database

- Host: db.example.com
- Password: hunter2

Manual setup

If npx secrets-mcp setup doesn't work, register manually:

claude mcp add secrets-mcp -s user -- npx -y secrets-mcp serve

How it works

• Reads ~/.secrets.md (or $SECRETS_VAULT_PATH) on each tool call
• Parses Markdown headings into sections
• No encryption, no dependencies beyond the MCP SDK — just a file

Portability

To move to a new machine:

1. Copy your ~/.secrets.md file
2. Run npx secrets-mcp setup

License

MIT