Allows an AI client to list, search, and read Markdown or text files within a specific directory.
Also known as SamuelDharshi/Proofmark, proofmark-notes
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Nov 7, 2026
- License
- —
What is Proofmark Notes MCP?
Proofmark Notes allows an AI client to list, search, and read Markdown or text files within a specific directory.
Summary generated from the project's README
About Proofmark Notes MCP server
Proofmark Notes provides a read-only interface for AI clients to interact with a specific collection of documentation. It allows users to manage information stored in Markdown or plain text formats within a designated directory. By setting the NOTES_ROOT environment variable, you can point the server to a specific folder where it will resolve all file paths, including those involving symlinks.
Developers use this server to give AI models access to local knowledge bases without risking accidental file modifications. The server includes three specific tools: list_notes for viewing all available files, search_notes for finding specific content, and read_note for retrieving the text of a single file. It is restricted to reading .md, .markdown, and .txt files, and each individual note read is limited to a maximum size of 64 KB.
This tool is part of the Proofmark trust gate ecosystem. It operates locally via npx and requires no external API keys, making it a secure way to ground an AI in your private notes.
Written from the project's README. Every use case is checked against a quote from it.
How to install Proofmark Notes MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Proofmark Notes MCP in Claude Code
$ claude mcp add proofmark-notes -- npx -y proofmark-notesInstall Proofmark Notes MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"proofmark-notes": {
"command": "npx",
"args": [
"-y",
"proofmark-notes"
]
}
}
}Install Proofmark Notes MCP in VS Code
.vscode/mcp.json
{
"servers": {
"proofmark-notes": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"proofmark-notes"
]
}
}
}Install Proofmark Notes MCP in VS Code CLI
$ code --add-mcp '{"name":"proofmark-notes","type":"stdio","command":"npx","args":["-y","proofmark-notes"]}'Install Proofmark Notes MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"proofmark-notes": {
"command": "npx",
"args": [
"-y",
"proofmark-notes"
]
}
}
}Install Proofmark Notes MCP in Codex
$ codex mcp add proofmark-notes -- npx -y proofmark-notesInstall Proofmark Notes MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.proofmark-notes] command = "npx" args = ["-y", "proofmark-notes"]
Install Proofmark Notes MCP in Gemini CLI
$ gemini mcp add -s user proofmark-notes npx -- -y proofmark-notesInstall Proofmark Notes MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"proofmark-notes": {
"command": "npx",
"args": [
"-y",
"proofmark-notes"
]
}
}
}Configuration
NOTES_ROOTThe only folder the server may read notes from. Defaults to the working directory.
| Name | Description | |
|---|---|---|
| NOTES_ROOT | The only folder the server may read notes from. Defaults to the working directory. |
Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachablesamueldharshi/proofmark is public and reachablegithub.com/samueldharshi/proofmark ↗Pass
- Package names this repository as its sourceproofmark-notes names samueldharshi/proofmark as sourcenpmjs.com/package/proofmark-notes ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-07github.com/samueldharshi/proofmark ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from proofmark-notesPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubproofmark-notes
A read-only MCP server for a folder of notes. List, search and read .md and .txt files, confined to one folder.
mcp-name: io.github.SamuelDharshi/proofmark-notes
Tools:
list_notes: list every note.search_notes: find notes containing some text.read_note: read one note, up to 64 KB.
Every path is resolved inside NOTES_ROOT (default: the working directory), symlinks included. Only .md, .markdown and .txt files are read. The server never writes.
{
"mcpServers": {
"notes": { "command": "npx", "args": ["-y", "proofmark-notes"], "env": { "NOTES_ROOT": "/path/to/notes" } }
}
}
Part of Proofmark, the MCP trust gate. Check this server's live trust status at https://proofmark-web.vercel.app/check?server=io.github.SamuelDharshi/proofmark-notes
Proofmark Notes MCP questions
How do I add Proofmark Notes MCP to Claude Code?
Run claude mcp add proofmark-notes -- npx -y proofmark-notes in your terminal. Add --scope user to make it available in every project.
How do I add Proofmark Notes MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What file types can the server read?
The server only reads .md, .markdown, and .txt files.
Can the server modify my notes?
No, the server is read-only and never writes to your files.
How can I specify which folder to use for my notes?
You can set the NOTES_ROOT environment variable to your desired path.