secrets-mcp

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:

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