SSyncDev

Monthlet MCP Server

Search, read and, with permission, edit the notes in your local monthlet vault from Claude and other MCP clients.

Local server

What is the Monthlet MCP Server?

Notes kept in a desktop app usually sit out of reach of an AI assistant. The Monthlet MCP server closes that gap for people who already keep their notes, sheets and attachments in monthlet on macOS or Windows. The server itself lives inside the monthlet app. What you install is a tiny Node.js bridge, monthlet-mcp.cjs, which an MCP client launches over stdio and which forwards each message to the app on 127.0.0.1. Nothing goes out to the internet.

How the bridge finds the app

While its MCP server is switched on, monthlet writes a small connection file holding the current port and an access token, and removes it when the server stops. On macOS it sits at ~/Library/Application Support/monthlet/mcp-endpoint.json; on Windows under %APPDATA%\monthlet\. The bridge reads it on every connection. That design matters: the token never appears in your client config, and regenerating it inside monthlet needs no client change at all.

Four switches, four levels of trust

Publishing the server turns on reading and nothing else. Every other capability has its own toggle, and all of them start off.

  • Publish (read only): search_notes, read_note, grep_notes, get_backlinks, read_pdf, read_sheet_range, view_image and related listing tools.
  • Allow writing: create_note, edit_note, update_tags, create_sheet, apply_sheet_edits, add_attachment and more.
  • Allow moving and renaming: move_note, rename_folder and their siblings.
  • Allow deleting: delete_note, delete_folder, merge_notes. Deleted items land in the system trash rather than vanishing.

Each tool carries readOnlyHint and destructiveHint annotations, so a client that honours them can pause and ask before anything changes.

Getting it running

You need monthlet running, Node.js 18 or newer, and the server enabled under Settings > Connectors > Publish to external agents > Publish. Claude Code users can install the monthlet plugin, or clone the bridge and register it by hand. Claude Desktop and other stdio clients get a node command pointing at the cloned monthlet-mcp.cjs. On macOS the app's Setup panel shows the exact command for the copy bundled inside it. Windows paths need doubled backslashes in JSON.

Before you rely on it

The Monthlet MCP server is strictly local. If monthlet is closed, or the server is off, every call returns an error saying so; there is no hosted fallback. The bridge is MIT-licensed, but monthlet itself is not open source, so you are trusting the app for everything past the relay. Readers comparing options can browse other integration servers, or the wider Other Integrations category for tools that connect assistants to personal apps.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
search_notesSearch notes in the vault (read-only switch).
list_notesList notes in the vault.
read_noteRead the contents of a note.
grep_notesPattern search across note text.
list_foldersList vault folders.
list_filesList files in the vault.
get_backlinksFind notes linking to a given note.
list_attachmentsList attachments.
view_imageView an image stored in the vault.
read_pdfRead a PDF stored in the vault.
read_fileRead a file from the vault.
read_chart_dataRead the data behind a chart.
read_sheet_rangeRead a range from a sheet.
create_noteCreate a note (requires Allow writing).
update_noteUpdate a note (requires Allow writing).
edit_noteEdit part of a note (requires Allow writing).
update_tagsChange a note's tags (requires Allow writing).
create_folderCreate a folder (requires Allow writing).
create_sheetCreate a sheet (requires Allow writing).
apply_sheet_editsApply edits to a sheet (requires Allow writing).
add_attachmentAdd an attachment (requires Allow writing).
move_noteMove a note (requires Allow moving and renaming).
move_folderMove a folder (requires Allow moving and renaming).
rename_noteRename a note (requires Allow moving and renaming).
rename_folderRename a folder (requires Allow moving and renaming).
delete_noteDelete a note to the system trash (requires Allow deleting).
delete_folderDelete a folder to the system trash (requires Allow deleting).
merge_notesMerge notes (requires Allow deleting).

How to install the Monthlet MCP Server

{
  "mcpServers": {
    "monthlet": {
      "command": "node",
      "args": [
        "/path/to/monthlet-mcp/monthlet-mcp.cjs"
      ]
    }
  }
}

Point the path at your clone of the bridge. On Windows escape backslashes, e.g. C:\\Users\\you\\monthlet-mcp\\monthlet-mcp.cjs. monthlet must be running with its MCP server published.

Frequently asked questions

No. The bridge only relays messages between your MCP client and the monthlet app over 127.0.0.1. It makes no other connections.