Pinto Notes
pinto-notes34 estrelas
Notes for iPhone and Mac that ChatGPT, Claude, Claude Code and Codex can read and edit. Feels like Apple Notes, imports it too. Open source, encrypted.
- Transporte
- stdio
- Status
- Local
Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDo publicador
Notes for iPhone and Mac that ChatGPT, Claude, Claude Code and Codex can read and edit. Feels like Apple Notes, imports it too. Open source, encrypted.
| Claude (web, desktop, iPhone) | Custom connector (OAuth) |
| Claude Code | claude mcp add or the Claude Code plugin |
| Codex | codex mcp add |
| Gemini CLI | Extension |
| Any MCP client | Streamable HTTP at https://mcp.pintonotes.com, OAuth 2.1 |
Download the Mac app and sign in with Apple or email.
Add the server to your AI:
ChatGPT or Claude: add a custom connector with the address https://mcp.pintonotes.com.
Claude Code:
claude mcp add --scope user --transport http pinto-notes https://mcp.pintonotes.com
Or install the plugin, which adds a skill that tells Claude how your notes are laid out:
claude plugin marketplace add pinto-notes/pinto-notes
claude plugin install amber-notes
Codex:
codex mcp add pinto-notes --url https://mcp.pintonotes.com
Gemini CLI:
gemini extensions install https://github.com/pinto-notes/pinto-notes
Approve it in Pinto Notes on your iPhone or Mac, and choose read only or read and edit.
Then try "find my Lisbon note and add a day in Sintra". The plugin keeps its old id, amber-notes, because renaming it would break existing installs.
New versions ship most days. Star the repo to follow along, and see Releases or the changelog for what changed.
*), dashed (-) and numbered lists. Return continues a list, Tab nests it.The Xcode project is generated from project.yml with XcodeGen. Folder and target names still say "Pane", the app's working name.
You need macOS 26 with Xcode 26, Homebrew, and Docker (for the local Supabase stack). A fresh clone runs entirely on your machine.
brew install xcodegen supabase/tap/supabase deno pnpm
git clone https://github.com/pinto-notes/pinto-notes.git
cd pinto-notes
supabase start # local Postgres, Auth, Storage and Functions on ports 56420–56429
xcodegen generate
open Pane.xcodeproj # run the "Pane" scheme on "My Mac" or an iPhone simulator
The app talks to the local stack through Config/Backend.xcconfig, which carries Supabase's standard local-only development key. To point your builds at a real project, create Config/Backend.local.xcconfig (gitignored) with your own PANE_SUPABASE_URL, PANE_SUPABASE_KEY and PANE_SHARE_URL.
Running on a physical device needs your own Apple team. Change DEVELOPMENT_TEAM in project.yml, and the bundle ids if you like.
scripts/qa-test.sh # Mac unit and interaction tests
scripts/prepush.sh --tests # before a push: compiles what ships, runs the suites you touched
deno test --allow-all supabase/functions/mcp/notes.test.ts
scripts/mcp-e2e.sh # MCP end-to-end, against the local stack
scripts/share-e2e.sh # share links end-to-end, against the local stack
(cd web && pnpm install && pnpm test && pnpm build) # share site
The interaction tests drive the real editor in an offscreen window, so they never move your mouse or take focus.
Everything the app needs runs on one Supabase project:
.env as SUPABASE_ACCESS_TOKEN=sbp_….scripts/deploy-backend.sh <project-ref>. It links the project, applies the migrations, deploys the functions, pushes the auth settings, and writes Config/Backend.local.xcconfig.web/ to any Next.js host and set PANE_SHARE_URL to it.In the app, open Settings → Connect an AI and follow the steps for your client. ChatGPT and Claude get a plain server address, https://mcp.pintonotes.com, and ask Pinto Notes for permission through OAuth: a page on pintonotes.com opens, where you answer in the app or sign in and answer on the web. Claude Code and Codex get a command with a revocable token. The app may still show the older address, https://mcp.ambernotes.app; it is the same server and keeps working. Connections are listed in Settings, where you can disconnect each one.
Everyone who has had a pull request merged, in the order they joined:
Want to be next? CONTRIBUTING.md has where to start, and ideas of your own are welcome in Discussions.
MIT. Made by Emil Wagman at Incredible.
Notes for iPhone and Mac that ChatGPT, Claude, Claude Code and Codex can read and edit. Feels like Apple Notes, imports it too. Open source, encrypted.
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Pinto Notes roda localmente via stdio.
Última verificação: 2026-11-13. Notes for iPhone and Mac that ChatGPT, Claude, Claude Code and Codex can read and edit. Feels like Apple Notes, imports it too. Open source, encrypted.