Skip to content
Back to search

noteporter-mcp

Apple Notes MCP server for Mac: let Claude, Cursor and any MCP client search, read, create and append to your notes, locally. By Tidyware.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tidyware-app--noteporter-mcp/badge.svg)](/listings/tidyware-app--noteporter-mcp)

HTML

<a href="/listings/tidyware-app--noteporter-mcp"><img src="/api/listings/tidyware-app--noteporter-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Download NotePorter from https://tidyware.app/noteporter/ , open the DMG and drag **NotePorter** into **Applications**. 2. Open NotePorter and follow the three steps on screen: 1. **Allow NotePorter to read your notes** — click *Open Settings* and turn on NotePorter under *System Settings → Privacy & Security → Full Disk Access*. 2. *(optional)* **Allow creating notes** — lets your AI add new notes. 3. **Connect your AI app** — click *Connect…* and pick **Claude Desktop** or **Cursor**. NotePorter adds itself to the app's MCP settings. 3. Quit and reopen Claude Desktop (or Cursor). Ask: *"Find my notes about the Lisbon trip and summarize them."*

Manual setup (any MCP client)

Command (stdio):

/Applications/NotePorter.app/Contents/MacOS/noteporter mcp

Claude Desktop — add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

{
  "mcpServers": {
    "noteporter": {
      "command": "/Applications/NotePorter.app/Contents/MacOS/noteporter",
      "args": ["mcp"]
    }
  }
}

Claude Code:

claude mcp add --scope user noteporter -- "/Applications/NotePorter.app/Contents/MacOS/noteporter" mcp

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 77 lines
  1. # NotePorter — Apple Notes MCP server for Mac
  2. Let Claude, Cursor and other MCP clients **search, read, create and append to your Apple Notes** — locally, on your Mac.
  3. NotePorter is a native macOS app with a built-in MCP server (stdio). Your notes never leave your Mac.
  4. - Website: https://tidyware.app/noteporter/
  5. - For AI agents: https://tidyware.app/noteporter/llms.txt
  6. - Price: $15 one-time (3-day full trial) · macOS 14 Sonoma or later · Apple silicon & Intel
  7. - Support: support@tidyware.app
  8. ## What your AI can do
  9. | Tool | What it does | Changes notes? |
  10. |---|---|---|
  11. | `search_notes` | Full-text search across all notes (title + body, case- and accent-insensitive). Args: `query`, `folder`, `limit` | No |
  12. | `get_note` | Read the full text of one note by id or exact title. Args: `id`, `offset` | No |
  13. | `list_notes` | List notes, newest edits first; filter by folder and date (`since`, `until`, e.g. `7d`). | No |
  14. | `list_folders` | List folders with note counts. | No |
  15. | `create_note` | Create a new note (plain text) in a folder. Args: `title`, `body`, `folder` | Creates only |
  16. | `append_to_note` | Add text to the end of an existing note. Args: `id`, `text` | Appends only |
  17. NotePorter never deletes or rewrites existing notes.
  18. ## Install (2 minutes)
  19. 1. Download NotePorter from https://tidyware.app/noteporter/ , open the DMG and drag **NotePorter** into **Applications**.
  20. 2. Open NotePorter and follow the three steps on screen:
  21. 1. **Allow NotePorter to read your notes** — click *Open Settings* and turn on NotePorter under
  22. *System Settings → Privacy & Security → Full Disk Access*.
  23. 2. *(optional)* **Allow creating notes** — lets your AI add new notes.
  24. 3. **Connect your AI app** — click *Connect…* and pick **Claude Desktop** or **Cursor**. NotePorter adds itself to the app's MCP settings.
  25. 3. Quit and reopen Claude Desktop (or Cursor). Ask: *"Find my notes about the Lisbon trip and summarize them."*
  26. ### Manual setup (any MCP client)
  27. Command (stdio):
  28. ```
  29. /Applications/NotePorter.app/Contents/MacOS/noteporter mcp
  30. ```
  31. Claude Desktop — add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
  32. ```json
  33. {
  34. "mcpServers": {
  35. "noteporter": {
  36. "command": "/Applications/NotePorter.app/Contents/MacOS/noteporter",
  37. "args": ["mcp"]
  38. }
  39. }
  40. }
  41. ```
  42. Claude Code:
  43. ```
  44. claude mcp add --scope user noteporter -- "/Applications/NotePorter.app/Contents/MacOS/noteporter" mcp
  45. ```
  46. ## Example prompts
  47. - "Find my notes about the Lisbon trip and summarize them."
  48. - "What did I write about the budget last month?"
  49. - "Make a note called *Meeting 21 Nov* with the action items from this chat."
  50. - "Add 'book Sintra tickets' to my Lisbon itinerary note."
  51. ## Privacy
  52. - Runs entirely on your Mac. NotePorter has no servers and uploads nothing; only your AI app sees the text it asks for.
  53. - Read-only tools never modify notes. Write tools only create new notes or append text.
  54. ## Troubleshooting
  55. - **"NotePorter cannot read your notes yet"** → turn on Full Disk Access for NotePorter (step 2.1), then try again.
  56. - **Claude doesn't show NotePorter tools** → fully quit Claude Desktop (⌘Q) and reopen it.
  57. - Still stuck? Email support@tidyware.app.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.