amber-notes
GitHub通过MCP服务器读写Pinto Notes应用中的笔记、清单和工作日志。支持搜索、创建、编辑Markdown内容,适用于记录站会、决策、工时及检查项等个人知识管理场景。
触发场景
安装
npx skills add pinto-notes/pinto-notes --skill amber-notes -g -y
SKILL.md
Frontmatter
{
"name": "amber-notes",
"description": "Use the person's notes in Pinto Notes (pintonotes.com, formerly Amber Notes) through the amber-notes MCP server. Use when they mention their notes, Pinto Notes, Amber Notes, a checklist, a work log, a standup, a timesheet or tracker, or ask to save, look up or update something \"in my notes\"."
}
Pinto Notes
Pinto Notes is the person's own notes app on Mac and iPhone. The amber-notes MCP server reads and edits the same notes they see in the app. Every change you make shows up there with Undo, and the previous version stays in the note's history. It was called Amber Notes until October 2026, and the app shows that name until it's updated; it's the same app.
If the tools are missing
The server needs a one-time sign-in. If no amber-notes tools are available, or a call says to sign in, tell the person to run /mcp, pick amber-notes, and choose Authenticate. A browser opens at pintonotes.com/connect: they open Pinto Notes or sign in there, then choose Read and Edit, or Read Only. They need the free app (pintonotes.com/download) and an account.
A read-only connection only has the reading tools. If a change is refused for that reason, say so; don't look for a way around it.
How to work with the notes
- The notes are files. Each note is a markdown file at a path like
Work/Acme.md; its first line is the title. A note's sub-notes and files sit in the folder with its name (Work/Acme/Agenda.md). Deleted notes are inRecently Deleted/. - Find before you write:
listfor folders, pinned and recent notes;searchfor anything specific. Read a note withfetchbefore you change it; a change to a note you haven't read, or that changed since, is refused. - Checklists are
- [ ] itemlines; tables are markdown tables. A tracker has a<!-- pane-table: … -->line above its table that gives each column's type. - Make the smallest change that does the job:
editis an exact find and replace (copy the text fromfetch, without the line numbers). Tick an item by editing- [ ]to- [x]; add a row to a table the same way. Usewriteonly when the person asks for a full rewrite. editandwriteanswer with checks, such as a tracker value out of range or a checklist line that no longer shows as one. Fix what they report.- Deleting is recoverable:
deletemoves a note to Recently Deleted for 30 days, andrestorebrings it back.historyandrestorewith a version undo an edit. - A note with
locked: trueis encrypted on the person's devices. Only its title is visible; don't try to read or change it. - When you're done, name the note you changed and what you changed, in one line.
Good uses from a coding session
- Write today's standup into a note, from the commits since yesterday.
- Add a decision to the project's note, under a "Decisions" heading.
- Keep a dated work log:
editunder today's date. - Read a checklist note (a release checklist, say) and go through it, ticking items as they're done.
版本历史
- 71cd169 当前 2026-11-21 16:08


