PinMark

space.pinmarkPublished by pinmark.spacev0.3.0Updated Nov 5, 2026

Create, search, read and organize PinMark sticky notes on your Mac. Fully local.

VerifiedSTDIODesktop onlyProductivity & WorkflowFiles & Storage

Overview

AI-generated overview

Lets an assistant create, search, read, edit and pin PinMark sticky notes on a Mac, including image notes, all stored locally.

What you can do
  • Create text notes from Markdown or a template, and image notes from local image files
  • Read, list and search notes by title, content, caption or image filename, with paging and trash filtering
  • Append to or update a note's content, title, color, paper or caption
  • Move notes to the trash, restore them, and list available templates
  • Pin notes to the desktop, unpin them, or bring a note to the foreground
When to use it
Useful when you want an assistant to capture ideas, logs or reference material as sticky notes on a Mac desktop, or to look up and update notes you already keep in PinMark.
Requirements
Runs as a local stdio process on a Mac (npm package @pinmark/mcp); the PinMark app must be installed. No authentication, environment variables or headers are declared. Some templates depend on the current PinMark plan.
Before you install
The assistant can change data: create, update, append to, trash, restore, pin and unpin notes. Updates replace the whole note body, so edits should start from the verbatim content returned by get_note. Image notes copy the chosen local file into PinMark. Pinning and opening notes affect the desktop and can activate the app.

Installation

In SourceWeft

  1. Open PinMark 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.

Tools

13

create_note

Create note

Create a new text note in PinMark. Content is Markdown. Alternatively create it from a template (template id from list_templates); a template cannot be combined with content. The note is not put on the desktop unless open is true (or pin_note is called later); isPinned in the result tells. Returns the new note.

Parametersopencolorpapertitlecontenttemplate

create_image_note

Create image note

Create an image note in PinMark from an image file on this Mac (PNG, JPEG, HEIC, GIF, …). The file is copied into PinMark; the original is not changed. The note is not put on the desktop unless open is true (or pin_note is called later); isPinned in the result tells.

Parametersopenpathrequiredtitle

append_to_note

Append to note

Append Markdown text to an existing text note (e.g. to maintain a running log). Does not act on notes in the trash.

ParametersopennoteIdrequiredcontentrequiredseparator

update_note

Update note

Update an existing note. Provide at least one of content, color, paper (text notes), title, or caption (image notes). content replaces the whole body: start from get_note's content (verbatim Markdown, including pinmark-asset:/// addresses), never from visibleText or preview. Does not act on notes in the trash.

ParameterscolorpapertitlenoteIdrequiredcaptioncontent

get_note

Get note

Fetch one note by id. Text notes return content (verbatim Markdown; base edits on it), visibleText (readable text for reading only) and assets (embedded images and drawings). Image notes return the caption and, by default, the image itself as image content; a long image comes in overlapping tiles, a few per call — continue with imageOffset = imageInfo.nextOffset.

ParametersnoteIdrequiredimageOffsetincludeImageincludeTrash

list_notes

List notes

List notes. Excludes the trash unless includeTrash is set. Results are sorted by last edit time (newest first, ties by noteId) and paged with offset/limit; page tells whether more remain. Paging is not a snapshot: notes edited, added or deleted between calls can shift results, and since is a filter, not a sync cursor.

ParameterstypelimitsinceoffsetonDesktopincludeTrash

search_notes

Search notes

Search notes by title, content, caption, or image filename. Results are sorted by last edit time (newest first, ties by noteId) and paged with offset/limit; page tells whether more remain. Paging is not a snapshot: notes edited, added or deleted between calls can shift results, and since is a filter, not a sync cursor.

ParameterstypelimitqueryrequiredsinceoffsetonDesktopincludeTrash

list_templates

List templates

List the note templates in PinMark, for create_note's template parameter. usable tells whether the current plan allows a template.

Takes no parameters.

delete_note

Delete note

Move a note to the trash. Recoverable with restore_note; not a permanent delete. Idempotent.

ParametersnoteIdrequired

restore_note

Restore note

Restore a note from the trash.

ParametersnoteIdrequired

pin_note

Pin note to desktop

Pin a note to the desktop: show it as a note window on the desktop. Idempotent. This is not 'float on top' (a separate window setting in the app). The result's isPinned tells whether the note is on the desktop.

ParametersnoteIdrequired

unpin_note

Unpin note from desktop

Unpin a note from the desktop: close its desktop window. The note stays in the workspace. Idempotent; fails with unpin_blocked if the note could not be saved and stays on the desktop.

ParametersnoteIdrequired

open_note

Open note

Bring a note to the foreground on the desktop (this one intentionally activates PinMark).

ParametersnoteIdrequired

Version history

1
  1. v0.3.0LatestNov 5, 2026

Score

65% 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
  • 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 listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.