amber-notes

GitHub

用于通过MCP服务器访问和编辑Pinto/Amber Notes应用中的笔记、清单及工作日志。支持搜索、读取、精确编辑、创建及恢复笔记,适用于记录站会、更新检查项或维护开发日志等个人知识管理场景。

plugins/amber-notes/skills/amber-notes/SKILL.md pinto-notes/pinto-notes

Trigger Scenarios

提及 Pinto Notes, Amber Notes 或 notes 要求保存、查找或更新笔记内容 需要填写站会、工时表或检查清单

Install

npx skills add pinto-notes/pinto-notes --skill amber-notes -g -y
More Options

Non-standard path

npx skills add https://github.com/pinto-notes/pinto-notes/tree/main/plugins/amber-notes/skills/amber-notes -g -y

Use without installing

npx skills use pinto-notes/pinto-notes@amber-notes

指定 Agent (Claude Code)

npx skills add pinto-notes/pinto-notes --skill amber-notes -a claude-code -g -y

安装 repo 全部 skill

npx skills add pinto-notes/pinto-notes --all -g -y

预览 repo 内 skill

npx skills add pinto-notes/pinto-notes --list

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 in Recently Deleted/.
  • Find before you write: list for folders, pinned and recent notes; search for anything specific. Read a note with fetch before you change it; a change to a note you haven't read, or that changed since, is refused.
  • Checklists are - [ ] item lines; 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: edit is an exact find and replace (copy the text from fetch, without the line numbers). Tick an item by editing - [ ] to - [x]; add a row to a table the same way. Use write only when the person asks for a full rewrite.
  • edit and write answer 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: delete moves a note to Recently Deleted for 30 days, and restore brings it back. history and restore with a version undo an edit.
  • A note with locked: true is 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: edit under today's date.
  • Read a checklist note (a release checklist, say) and go through it, ticking items as they're done.

Version History

  • 71cd169 Current 2026-11-21 16:08

Same Skill Collection

plugins/grok/pinto-notes/skills/pinto-notes/SKILL.md

Metadata

Files
0
Version
71cd169
Hash
178d9022
Indexed
2026-11-21 16:08

Accueil - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-21 16:35
浙ICP备14020137号-1