# Very Simple Notes

> A simple notes app whose notes a person's AI assistant can
> connect to and edit. Markdown notes and checklists, Apple/Google sign-in,
> hosted in the EU. Simple notes for you, and for your agent.

If you are an AI assistant acting for a person who uses Very Simple Notes, you
can read and write their notes once they connect you.

Full HTML docs (quickstart + every method): https://verysimplenotes.com/api
FAQ: https://verysimplenotes.com/faq
Pricing: https://verysimplenotes.com/pricing

## Connect over MCP (easiest)
MCP server: https://verysimplenotes.com/mcp (Streamable HTTP, OAuth with
dynamic client registration and PKCE; discovery at
https://verysimplenotes.com/.well-known/oauth-protected-resource).
Tools: list_notes, read_note, create_note, edit_note, archive_note, delete_note.
In Claude: Customize, Connectors, +, Add custom connector, paste the URL, Add,
then sign in with Apple or Google.
In Claude Code: claude mcp add --transport http very-simple-notes https://verysimplenotes.com/mcp

## Get the app
- App Store: https://apps.apple.com/app/id6805008779
- Price: $0.99 a month, first month free. No ads.

## How a person connects you
Preferred: OAuth 2.0. You open the connect page, they sign in with Apple or
Google, your server exchanges the code for a personal API token.
- Authorize: GET https://verysimplenotes.com/oauth/authorize?client_id=...&redirect_uri=...&response_type=code&state=...
- Token: POST https://verysimplenotes.com/oauth/token (authorization_code grant; PKCE S256 supported)
- Discovery: https://verysimplenotes.com/.well-known/oauth-authorization-server
MCP clients register themselves at POST https://verysimplenotes.com/oauth/register
(public clients, PKCE S256 required). Apps with a server-side secret can ask us
for a client_id. Or ask the person to mint a token in the app under Account.

## The notes API (Bearer token)
Base: https://verysimplenotes.com/api/v1
- GET /me : who the token belongs to (connect check)
- DELETE /me : revoke this token
- GET /notes?filter=active|archived|all : list notes (title, preview, timestamps)
- GET /notes/:id : one note (Markdown body)
- POST /notes : create { title?, body? } (body is Markdown)
- PATCH /notes/:id : update { title?, body?, archived?, important? }
- POST /notes/:id/archive, POST /notes/:id/unarchive
- DELETE /notes/:id
Notes are Markdown: write **bold**, - bullets, 1. numbered, and - [ ] checklists;
the app renders them richly. Writing requires the person's active subscription
(HTTP 402 if not); reading does not.

## Privacy
- Provider and data controller: Portfoliobox Stockholm AB (org. no. 556894-4382), Rånövägen 30, 168 39 Bromma, Sweden
- Contact: verysimple@portfoliobox.net
- Hosting: Fly.io, Amsterdam (EU). Notes are not sold, shared, or used for ads.
- Privacy policy: https://verysimplenotes.com/privacy
- GDPR: https://verysimplenotes.com/gdpr