Enables reading, searching, and managing personal secrets and notes stored in a local Markdown file by parsing document sections and headings.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@secrets-mcpfind my AWS access key"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 setupThis will:
Create
~/.secrets.mdif it doesn't existCreate a desktop shortcut to open it
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 all section titles |
| Get a section by title |
| Search by keyword |
| Add or update a 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: hunter2Manual setup
If npx secrets-mcp setup doesn't work, register manually:
claude mcp add secrets-mcp -s user -- npx -y secrets-mcp serveHow it works
Reads
~/.secrets.md(or$SECRETS_VAULT_PATH) on each tool callParses Markdown headings into sections
No encryption, no dependencies beyond the MCP SDK — just a file
Portability
To move to a new machine:
Copy your
~/.secrets.mdfileRun
npx secrets-mcp setup
License
MIT
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.