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
Markdown
[](/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
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
- # NotePorter — Apple Notes MCP server for Mac
- Let Claude, Cursor and other MCP clients **search, read, create and append to your Apple Notes** — locally, on your Mac.
- NotePorter is a native macOS app with a built-in MCP server (stdio). Your notes never leave your Mac.
- - Website: https://tidyware.app/noteporter/
- - For AI agents: https://tidyware.app/noteporter/llms.txt
- - Price: $15 one-time (3-day full trial) · macOS 14 Sonoma or later · Apple silicon & Intel
- - Support: support@tidyware.app
- ## What your AI can do
- | Tool | What it does | Changes notes? |
- |---|---|---|
- | `search_notes` | Full-text search across all notes (title + body, case- and accent-insensitive). Args: `query`, `folder`, `limit` | No |
- | `get_note` | Read the full text of one note by id or exact title. Args: `id`, `offset` | No |
- | `list_notes` | List notes, newest edits first; filter by folder and date (`since`, `until`, e.g. `7d`). | No |
- | `list_folders` | List folders with note counts. | No |
- | `create_note` | Create a new note (plain text) in a folder. Args: `title`, `body`, `folder` | Creates only |
- | `append_to_note` | Add text to the end of an existing note. Args: `id`, `text` | Appends only |
- NotePorter never deletes or rewrites existing notes.
- ## Install (2 minutes)
- 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`:
- ```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
- ```
- ## Example prompts
- - "Find my notes about the Lisbon trip and summarize them."
- - "What did I write about the budget last month?"
- - "Make a note called *Meeting 21 Nov* with the action items from this chat."
- - "Add 'book Sintra tickets' to my Lisbon itinerary note."
- ## Privacy
- - Runs entirely on your Mac. NotePorter has no servers and uploads nothing; only your AI app sees the text it asks for.
- - Read-only tools never modify notes. Write tools only create new notes or append text.
- ## Troubleshooting
- - **"NotePorter cannot read your notes yet"** → turn on Full Disk Access for NotePorter (step 2.1), then try again.
- - **Claude doesn't show NotePorter tools** → fully quit Claude Desktop (⌘Q) and reopen it.
- - Still stuck? Email support@tidyware.app.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.