Proofmark Notes

io.github.SamuelDharshiPublished by GitHub account SamuelDharshiv1.0.0Updated Nov 7, 2026

Read-only notes: list, search and read Markdown or text notes inside one folder.

VerifiedSTDIODesktop onlyFiles & StorageKnowledge & Memory

Overview

AI-generated overview

A read-only MCP server that lets an assistant list, search and read Markdown and text notes inside a single folder.

What you can do
  • List every note in the configured folder
  • Search notes for text they contain
  • Read a single note, up to 64 KB
  • Restrict access to .md, .markdown and .txt files inside one root folder
When to use it
Useful when you keep notes as Markdown or text files in one folder and want an assistant to look things up in them without giving it write access or access to the rest of the disk.
Requirements
Runs locally over stdio, typically via npx with the npm package proofmark-notes, so Node.js is needed. Set the NOTES_ROOT environment variable to the folder holding the notes; it defaults to the working directory. No authentication is declared.
Before you install
The server is read-only and never writes, but everything under NOTES_ROOT, including symlink targets, is reachable, so point it at a folder that holds nothing sensitive beyond the notes you intend to share. Note content is passed to the assistant and its model provider.

Installation

In SourceWeft

  1. Open Proofmark Notes in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

proofmark-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.

json
{  "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

Source: publish/notes-server/README.md at commit 6a1f161

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestNov 7, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.