Amber Notes
Amber Notes is a free, open-source (MIT) notes app for iPhone and Mac.
What it can do
- Get Overview: An overview of the person's Amber Notes: folders with counts, pinned notes and the most recently edited notes.
- Search Notes: Full-text search across titles and bodies. Returns ranked notes with a highlighted snippet («match»). Locked notes are left out.
- List Notes: List notes, newest first, optionally in one folder. Use for browsing; use search_notes to find something.
What data it sees
Do you need an account
No: the server works without sign-in
Amber Notes is a free, open-source (MIT) notes app for iPhone and Mac. Its remote MCP server lets ChatGPT, Claude, Claude Code, Codex, Gemini CLI and Incredible search, read and edit your notes, from any device, with nothing to install on your computer. Every change an AI makes shows up tinted in the note with Undo, and the earlier version stays in the note's history. Notes are end-to-end encrypted with a key in your iCloud Keychain, and each AI connection is approved on your own iPhone or Mac by typing a two-digit number.
How to connect
How to connect Amber Notes to Claude
The server address to paste into Claude settings:
https://amber-notes--neobyte01.run.tools
- Open Claude (claude.ai or the desktop app).
- Go to Settings → Connectors.
- Click Add custom connector.
- Paste the server address copied below into Remote MCP server URL and click Add.
- In a chat, click + → Connectors and switch the new connector on.
Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.
Authorization
After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.
How to connect Amber Notes to ChatGPT
The server address to paste into ChatGPT settings:
https://amber-notes--neobyte01.run.tools
- Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
- Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
- Open Settings → Connectors and click Create.
- Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
- Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
- In a new chat open + → Apps/Connectors and enable the connector.
OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.
Authorization
On first use ChatGPT opens the service's sign-in window. Sign in and approve access.
How to connect Amber Notes to Cursor
The server address to paste into Cursor settings:
https://amber-notes--neobyte01.run.tools
Fastest: click Open in Cursor below and confirm the prompt.
Manually:
- In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
- Paste the JSON copied below into
~/.cursor/mcp.json(per project:.cursor/mcp.jsonin the repo root). - Save the file. The server appears in the MCP list; authorize it there if asked.
Authorization
If the service needs sign-in, an authorize button appears next to the server in the MCP list.
Server tool list (27)
Raw names from tools/list. Only developers need these.
| get_overview | An overview of the person's Amber Notes: folders with counts, pinned notes and the most recently edited notes. |
| search_notes | Full-text search across titles and bodies. Returns ranked notes with a highlighted snippet («match»). Locked notes are left out. |
| list_notes | List notes, newest first, optionally in one folder. Use for browsing; use search_notes to find something. |
| read_note | Returns a note's markdown with its folder, dates, version and outline. For long notes, read a line range; set line_numbers to see where headings are. |
| create_note | Creates a note from markdown. The first line becomes the title (write it as plain text or '# Title'). |
| edit_note | Precise edits: each old_text must match the note exactly once (copy it from read_note) and is replaced by new_text. Edits apply in order. Fails without changing anything if one doesn't match. |
| append_to_note | Adds markdown to the end of a note, or to the end (or start) of the section under a heading. Good for logs, lists and journals. |
| replace_note_body | Replaces the whole note with new markdown. Use only for full rewrites; prefer edit_note. The person sees the change in Amber Notes with Undo, and the old version stays in history. |
| set_checklist_item | Checks or unchecks a '- [ ] item' line, matched by its text. |
| move_note | Moves a note to another folder, creating the folder if it doesn't exist. Use a path like "Work/Clients" to nest. |
| pin_note | Pins a note to the top of the list, or unpins it. Pinned state shows as `pinned` in every note listing. |
| delete_note | Moves a note and its sub-notes to Recently Deleted. This can be undone: restore_note brings it back within 30 days. |
| restore_note | Brings a note (and its sub-notes) back from Recently Deleted. |
| list_folders | All folders as paths like "Work/Q4 planning", with how many notes each shows in the app. |
| create_folder | Creates a folder; use a path like "Work/Clients" to nest it. |
| rename_folder | Renames a folder in place. Its notes and sub-folders stay inside it. |
| delete_folder | Deletes a folder and its sub-folders. Their notes (and those notes' sub-notes) go to Recently Deleted, and each can be brought back with restore_note within 30 days; the folders themselves are not restored. |
| note_history | Earlier versions of a note, newest first, with who changed it (app or an AI client). |
| restore_revision | Puts an earlier version (from note_history) back as the note's body. The current body is kept in history too. |
| create_sub_note | Creates a note that lives inside another note: it's linked from the parent (a [Title](pane-note:id) line added at the end, or under a heading) and doesn't show in the main list. |
| list_files | Files kept in Amber Notes (PDFs, spreadsheets, images…), newest first, with the notes that embed them. |
| get_file | A file's details and its contents: text files (CSV, JSON, markdown…) as text, images as an image, PDFs and other files as an attached resource. Files over 8 MB can only be opened in Amber Notes. |
| read_table | Reads a table in a note: its columns (with types and allowed values for trackers) and its rows as objects. Use before logging so you use the right column names and values. |
| log_table_row | Adds a row to a table. In a tracker with a date column it updates that date's row if there is one (the date defaults to today). Values are checked against each column's type: scales must be in range, choices one of the options, Yes/No also takes true/false. |
| delete_table_row | Removes the row for a date (trackers) or at a 0-based row index from a table. |
| search | Search the person's Amber Notes by words or phrases. Returns note ids and titles; read one with fetch. Locked notes are left out. |
| fetch | Fetch an Amber Notes note by id (from search) as its full markdown, with folder, pinned state and last edit time. |