SoloMD MCP Server: Setup for Claude, Cursor and Other Apps

• Lists notes in your vault

  Walks the notes folder and returns each note's path, title, modified time, size and a short summary. It returns the 100 newest by default.

  Try: “List my 20 most recently changed notes.”

  Files · list_notes

• Reads one note in full

  Returns the whole note plus its front matter, headings, tags and outgoing [[wikilinks]].

  Try: “Read my note on project-alpha.”

  Files · read_note

• Searches text across the vault

  Finds a word or regex in your notes, using ripgrep if it is installed. It stops at 200 hits and shows 3 lines of context.

  Try: “Search my notes for 'rate limiter'.”

  Files · search

• Shows which notes link to a note

  Lists every place another note links to the one you name, matching names without regard to case.

  Try: “Which notes link to Meeting Notes?”

  Files · get_backlinks

• Counts tags across the vault

  Totals up #tags in note bodies and tags: in front matter.

  Try: “What tags do I use most?”

  Files · list_tags

• Shows a note's headings

  Returns the headings of one note, level 1 to 6, with line numbers.

  Try: “Give me the outline of my weekly review note.”

  Files · get_outline

• Lists every checkbox task

  Collects all - [ ] and - [x] items across the vault with file, line and done state. You can filter by done.

  Try: “List my open tasks.”

  Files · list_tasks

• Shows a note's saved history

  Lists the commits in SoloMD's AutoGit history that touched one note, newest first.

  Try: “Show the history of my journal note.”

  Files · autogit_log

• Compares two versions of a note

  Shows a unified diff of one note between two AutoGit commits. With no commits given it uses the latest one that touched the note.

  Try: “What changed in this note last time?”

  Files · autogit_diff

• Shows GitHub sync state

  Reads the vault's sync settings for its remote, branch and encryption.

  Try: “Is my vault synced to GitHub?”

  Files · sync_status

• Builds a public share link

  Returns the solomd.app share URL for a note in a vault linked to a GitHub repo, and refuses if the vault is not linked.

  Try: “Give me the share link for my roadmap note.”

  Files · share_url

• Reads the steps of an agent run

  Returns the recorded steps of one SoloMD agent run by run ID. An unknown run ID is an error.

  Try: “Show the trace for run 2026-10-30-weekly.”

  Files · read_agent_trace

• Creates a note

  Creates a .md, .markdown or .txt note, adding missing folders in the vault. It replaces an existing note only if the call allows overwriting. Needs --allow-write.

  Try: “Create notes/ideas.md with this list.”

  Write · write_note

• Adds text to a note

  Appends text to the end of an existing note. Needs --allow-write.

  Try: “Append today's summary to my daily note.”

  Write · append_to_note

• Restores an earlier version of a note

  Puts a note's content back to what it was in an AutoGit commit, replacing the current text. Needs --allow-write.

  Try: “Roll my journal note back to yesterday's version.”

  Write · autogit_rollback

Watch out for

• Only with --allow-write can it change notes

  With the flag on, write_note, append_to_note and autogit_rollback change files in your vault. Rollback replaces a note's current text with an older version. Keep the vault under version control. github.com

• export_note can write outside the vault

  With --allow-write, export_note can save to a folder outside the workspace. It does not replace an existing file unless the call sets overwrite to true. github.com

• HTTP mode without a token is open

  The optional HTTP mode binds to 127.0.0.1 by default. Without --auth-token, anything that can reach the address can use it, so always set a token and keep the default bind. github.com

• Write tools show up even when off

  The write tools are listed to the assistant by default, but calls fail with a restart message until you add --allow-write. github.com

Security advisories