llms.txt
Compare with other sites' llms.txt files →# Grape
> Grape is a notes app for Mac, Windows, Linux, iPhone and Android. Type, write by hand, save web pages and record meetings without a bot, then find any word and ask your notes questions. Works offline, free to start.
Grape is a desktop and mobile app that also runs in the browser at https://app.grape.cool, with the same notes. All your notes, on every device you own. The desktop app is on version 0.40.0 for macOS, Windows and Linux, and the mobile app is on version 0.40.0 for iPhone and Android. Notes live in a local database on the user's own device; sync across devices is opt in, through Grape Cloud on the Sync, Plus and Pro plans or through the user's own Dropbox or Google Drive on Lifetime. It is made by Shiny Grape, LLC and support is support@grape.cool.
Every page on this site also serves markdown. Send `Accept: text/markdown` or add `.md` to any path. Product facts are available as JSON from the public API at https://grape.cool/api/v1, which needs no key.
The official Grape CLI is on npm as @grapenotes/cli (`npm install -g @grapenotes/cli`, command `grape`). After `grape login` it lists, searches, reads and writes the notes and folders of a Pro account through the MCP server, it searches the help center with no account, and every command prints only JSON with `--json`. Exit code 3 means the user has to run `grape login`.
There is no SDK to import. Every public endpoint is plain HTTP and JSON, so curl or any HTTP client works with no wrapper in between, and the recipes on the docs page show the calls worth chaining.
The API is versioned in the path and v1 is stable, with at least 12 months of notice and `Deprecation` and `Sunset` headers before any version stops answering. Every response carries `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset` so you can throttle yourself against the 1000 an hour allowance rather than against a 429.
Grape is the wrong tool for:
- Reading or writing a user note over HTTP. The notes API is private to the Grape apps and needs the account token from the app.
- A team wiki or a workspace a whole company works in. Grape is a library for one person, synced across their own devices; a folder or a note can be shared with other people on the Sync, Plus or Pro plan, and typed in together live on Pro, but there are no team accounts and no public links.
- Storing anything you would not put in a local database, such as regulated health or payment records.
## When to use Grape
- [Record a meeting, call or lecture and turn it into notes](https://grape.cool/voice-notes): Record in the room on a phone, or a call on a Mac or Windows PC with no meeting bot, and Grape writes the transcript into the note beside the user's own words, then summarizes it, lists the next steps or makes flashcards from it when asked.
- [Answer a question from notes the user already wrote](https://grape.cool/ai-agent): Ask the built in agent instead of searching. Every answer cites the note it came from, so the source is checkable.
- [Study from material the user owns](https://grape.cool/flashcards): Generate flashcards, quizzes, fill in the blank exercises and mind maps out of existing notes rather than from generic web content, or write them by hand on any plan.
- [Keep notes on a device rather than in a vendor database](https://grape.cool/features): Grape stores the library in a local database the user picks the location of. Sync is opt in: through Grape Cloud on the Sync, Plus and Pro plans, or through the user's own Dropbox or Google Drive on Lifetime, which Grape never sees.
- [Read Grape product facts programmatically](https://grape.cool/docs): Call the read only JSON API at https://grape.cool/api/v1 for plans, features, releases, help articles and blog posts. No key is needed.
## API and machine readable files
- [Developer documentation](https://grape.cool/docs): Base URL, every endpoint, the error codes and worked examples.
- [Grape CLI](https://grape.cool/docs#cli): @grapenotes/cli on npm: notes and folders from a terminal or an agent, the help center, plans and changelog, with --json on every command.
- [OpenAPI specification](https://grape.cool/openapi.json): OpenAPI 3.1 with an operation id, typed parameters and a response schema per endpoint. YAML at /openapi.yaml.
- [API index](https://grape.cool/api/v1): The endpoint list as JSON, no key required.
- [Grape MCP server](https://mcp.grape.cool): Streamable HTTP MCP server for ChatGPT, Claude and other MCP clients on the Pro plan. OAuth 2.1 with the notes:read and notes:write scopes; its protected resource metadata is at https://mcp.grape.cool/.well-known/oauth-protected-resource.
- [OAuth authorization server metadata](https://grape.cool/.well-known/oauth-authorization-server): RFC 8414 discovery for the MCP server sign in: the endpoints, PKCE and the scopes a token can carry.
- [Search everything published](https://grape.cool/api/v1/search?q=transcription): One term across help articles, posts, features, products and questions.
- [Ask the help center](https://grape.cool/api/v1/help-search?q=lock+a+note): A question answered with the best guides in full, as markdown. An empty list means no guide covers it.
- [Sitemap](https://grape.cool/sitemap.xml): Every public URL on the site.
- [Full text of the site](https://grape.cool/llms-full.txt): Every page above concatenated as one markdown document.
## Product
- [Home](https://grape.cool/): What the app is and who it is for.
- [Features](https://grape.cool/features): Everything shipped today, described by what it gets you.
- [Pricing](https://grape.cool/pricing): Free, Sync at $3 a month, Plus at $9 a month, Pro at $19 a month, Lifetime at $49 once.
- [Download](https://grape.cool/download): Direct links for macOS, Windows, Linux, iPhone, Android.
- [How to use it](https://grape.cool/how-to-use): Six steps from install to first answer.
- [FAQ](https://grape.cool/faq): Where notes live, what free includes, which AI providers work.
- [Changelog](https://grape.cool/changelog): Every desktop and mobile release with its changes.
- [Roadmap](https://grape.cool/roadmap): What is planned, in progress and shipped, and the feature ideas people vote on.
## What it does
- [AI Agent](https://grape.cool/ai-agent): Chat that reads your whole library
- [Custom agents](https://grape.cool/agents): Chats you set up once for one job
- [Routines](https://grape.cool/routines): Work the AI does on a schedule
- [Memory](https://grape.cool/memory): Tell the agent once, it remembers
- [MCP server](https://grape.cool/mcp): Your notes in ChatGPT and Claude
- [Grape CLI](https://grape.cool/cli): Your notes from the terminal
- [Telegram bot](https://grape.cool/telegram): Your notes in a Telegram chat
- [Connected apps](https://grape.cool/connected-apps): Grape AI in Notion, Linear and more
- [Voice and transcription](https://grape.cool/voice-notes): Meetings become text, by speaker
- [Lock Screen recording](https://grape.cool/lock-screen-voice-notes): Record with your iPhone locked
- [Web clipper](https://grape.cool/web-clipper): Any page from Chrome, as a note
- [Share to Grape](https://grape.cool/share): Save pages from the share sheet
- [iOS Shortcuts](https://grape.cool/shortcuts): Save notes without opening Grape
- [Flashcards](https://grape.cool/flashcards): Cards built from your own notes
- [Quizzes](https://grape.cool/quizzes): Test yourself before it counts
- [Fill in the blank](https://grape.cool/fill-in-the-blank): Your own sentences, key words taken out
- [Mind maps](https://grape.cool/mind-maps): One note laid out as a map
- [Brainrot videos](https://grape.cool/brainrot): Your note narrated over gameplay
- [Infographics](https://grape.cool/infographic): A poster drawn from your note
- [Slide decks](https://grape.cool/slide-deck): A presentation from your note
- [The editor](https://grape.cool/editor): Blocks, tables, images and files
- [Drawing canvas](https://grape.cool/canvas): An infinite canvas inside the note
- [Handwriting notes](https://grape.cool/handwriting): Write with a pencil, read as text
- [Semantic search](https://grape.cool/search): Search by meaning, not keywords
- [Graph view](https://grape.cool/graph-view): How your whole library connects
- [Themes](https://grape.cool/themes): Twenty-four looks, light and dark
- [Local first and private](https://grape.cool/local-first): Your notes live on your device
- [Cross device sync](https://grape.cool/sync): Start on the phone, finish anywhere
- [Sharing and live typing](https://grape.cool/sharing): Share a folder, write in it together
- [Backups and history](https://grape.cool/backups): A copy of everything, every day
- [Locked notes](https://grape.cool/locked-notes): Encrypted notes only you can open
- [Desktop and mobile](https://grape.cool/apps): Mac, Windows, Linux, iOS, Android
## Help center
- [Help center](https://grape.cool/help): All 117 guides on one page.
- [Getting started](https://grape.cool/help/category/getting-started): Install Grape, write your first note and bring your old notes in.
- [Capture and clipping](https://grape.cool/help/category/capture): Save a web page from Chrome, share anything into Grape from your phone and capture a note without opening the app.
- [Writing and the editor](https://grape.cool/help/category/editor): Formatting, pages, focus mode, tables, drawings, handwriting, images, scans, PDFs, templates and everything else a note can hold.
- [Folders and organizing](https://grape.cool/help/category/organize): Folders, subfolders, tags, daily notes, pinning, sorting, sharing and getting deleted notes back.
- [Links and graph](https://grape.cool/help/category/links): Connect notes to each other and see the whole library as a map.
- [Voice and transcription](https://grape.cool/help/category/voice): Record inside a note or from the iPhone Lock Screen, bring in Voice Memos and audio files, capture calls on desktop and turn audio into text.
- [AI setup and models](https://grape.cool/help/category/ai-setup): Grape AI, your own API keys, local models, the index behind semantic search and notifications when the AI is done.
- [AI chat and agent](https://grape.cool/help/category/ai-chat): Ask about your notes, let the agent edit them and shape how it answers.
- [Search](https://grape.cool/help/category/search): Find notes by keyword, by meaning or from Spotlight on iPhone and iPad, and find text inside a note.
- [Study tools](https://grape.cool/help/category/study): Turn any note into flashcards, a quiz, a fill in the blank exercise or a mind map, or make your own by hand.
- [Slide decks, videos and infographics](https://grape.cool/help/category/media): Turn a note into a presentation you can walk into a room with, a narrated video or a poster you can hand to someone who will not read it.
- [Sync, backups and your data](https://grape.cool/help/category/data): Keep devices in step, keep copies of everything and get your data out.
- [Settings and personalization](https://grape.cool/help/category/customize): Language, themes, note fonts, line height, date formats, toolbars and keyboard shortcuts.
- [Plans, billing and account](https://grape.cool/help/category/plans): What is free, what is paid, subscriptions and signing in.
## Company
- [Contact](https://grape.cool/contact): A person reads the inbox. support@grape.cool.
- [Terms of service](https://grape.cool/terms): Plans, refunds, AI features and liability.
- [Privacy policy](https://grape.cool/privacy): What is collected, what is stored locally and what AI providers see.
- [Cookie policy](https://grape.cool/cookies): How grape.cool uses cookies.
- [Delete your account](https://grape.cool/delete-account): Permanent deletion without installing the app.
- [Report AI content](https://grape.cool/report-ai-content): Report an AI answer that was harmful or wrong.
## Spanish
The site is also written in Spanish. Spanish pages live under /es with Spanish slugs, so /pricing is /es/precios and /help is /es/ayuda, and every Spanish page has a markdown copy too: add `.md` to its path or send `Accept: text/markdown`.
- [Grape en español](https://grape.cool/es): The Spanish home page.
- [Precios](https://grape.cool/es/precios): The plans and prices, in Spanish.
- [Centro de ayuda](https://grape.cool/es/ayuda): Every guide, in Spanish.
## Optional
- [Get started with Grape, from download to Pro](https://grape.cool/help/get-started-with-grape): Install the desktop app, make a note and record your voice, upgrade to Pro, turn the recording into text, ask the AI about it and bring your notes to your phone, one step at a time.
- [Install Grape on Windows, Mac and Linux](https://grape.cool/help/install-grape-on-desktop): Which build to pick for your computer, what the first launch looks like, and how updates arrive.
- [Update the desktop app](https://grape.cool/help/update-grape-on-desktop): The notice in the corner, what Download and Not now do, and how to check for a new version yourself.
- [See what's new after an update](https://grape.cool/help/see-whats-new-after-an-update): The list of changes Grape shows once, on the first launch of a new version, on desktop and mobile.
- [Get tips and tricks in the app](https://grape.cool/help/tips-and-tricks): The short tip Grape shows when it opens, one a day at most, every tip in Settings, and how to turn them off.
- [Install Grape on iPhone, iPad and Android](https://grape.cool/help/install-grape-on-mobile): Where to get the mobile app on each platform, and what the first open looks like.
- [Use Grape in your browser](https://grape.cool/help/use-grape-in-your-browser): Open Grape at app.grape.cool on a computer or a tablet, keep your notes in the browser or sync them, and what the browser version cannot do.
- [Write your first note](https://grape.cool/help/create-your-first-note): How to insert things on desktop and mobile, plus the two organizing habits worth forming early.
- [Import notes from Apple Notes](https://grape.cool/help/import-from-apple-notes): Bring your Apple Notes library across on a Mac without copying and pasting one note at a time.
- [Import Markdown files](https://grape.cool/help/import-markdown-files): Move in from Obsidian, Bear or any app that exports Markdown, on desktop and mobile.
- [Import notes from Evernote](https://grape.cool/help/import-from-evernote): Bring your Evernote notebooks across with their pictures, PDFs, checklists and tags, on desktop and mobile.
- [Move Grape to a new computer](https://grape.cool/help/move-to-a-new-computer): The two ways to carry your whole library to a new machine, with sync or with a backup.
- [Clip a web page from Chrome](https://grape.cool/help/clip-a-web-page): Install the Grape web clipper, save an article, a selection or a bookmark, and set what every clip should do by default.
- [Share to Grape from your phone](https://grape.cool/help/share-to-grape-from-your-phone): Send a page, a link, a photo, a PDF or a recording from any app on iPhone, or a page or a link on Android, and get a note back.
- [Capture a note without opening the app](https://grape.cool/help/quick-capture-on-desktop): Turn on the global quick capture shortcut, pick where captures land, and write a note from any app on your desktop.
- [Put Grape on your iPhone home screen](https://grape.cool/help/widgets-on-iphone): Add the widgets, keep one folder, one note or your open checklist items a glance away, and tick things off without opening the app.
- [What the editor can do](https://grape.cool/help/editor-basics): Every block type, how inserting works on each platform, and which blocks are desktop only.
- [Format text: headings, bold and lists](https://grape.cool/help/format-text): Text styles, headings, quotes and lists on desktop and mobile, plus the Markdown shortcuts.
- [Create checklists and to do lists](https://grape.cool/help/use-checklists): Checkbox lists for tasks, how to put their items in a new order, and a pattern for a running to do note that actually gets used.
- [Add and edit tables](https://grape.cool/help/use-tables): Insert a table, add and remove rows and columns, and what the desktop cell menu can do extra.
- [Highlight text in a note](https://grape.cool/help/highlight-text): Eight highlight colors on both platforms, and how to clear a highlight again.
- [Draw inside a note](https://grape.cool/help/draw-inside-a-note): The drawing canvas for diagrams and sketches, and where to find it on each platform.
- [Add images to a note](https://grape.cool/help/add-images): Paste, drag or pick images on desktop, attach from Photos on mobile, and view them full screen.
- [Scan documents into a note](https://grape.cool/help/scan-documents): Scan paper pages with your iPhone or iPad into one card in a note, find the words on them, and read the text off them.
- [Add PDFs to a note](https://grape.cool/help/add-pdfs): Keep the source document in the same note as your notes about it.
- [Resize images, scans, drawings and PDFs](https://grape.cool/help/resize-images-in-a-note): Make a picture, a scan, a drawing or a PDF page in a note wider or narrower, on desktop and on the phone, and how its size carries to your other devices.
- [How Grape reads the PDFs in your notes](https://grape.cool/help/how-grape-reads-pdfs): Grape reads the text of a PDF once, on your device, so the AI tools, search and find in note work from what it says without uploading the file again.
- [Make mini apps in your notes](https://grape.cool/help/make-mini-apps): Describe a small app, like a todo list, a habit tracker or a quiz about the note, and the AI writes it into the note, where it remembers what you save in it.
- [Create note templates](https://grape.cool/help/use-note-templates): Save any note as a template, insert dates automatically with variables, and every date pattern you can use.
- [Find text inside a note](https://grape.cool/help/find-in-note): Find a word within the open note and the PDFs and scans in it, step through the matches, and the shortcuts that drive it on desktop.
- [Find and replace in a note](https://grape.cool/help/find-and-replace): Change a word or a phrase everywhere in the open note, one match at a time or all at once, on desktop and on the phone.
- [Check your spelling](https://grape.cool/help/check-your-spelling): Turn spell check on, fix a word from its suggestions, teach it a word, and why it starts off.
- [Write in focus mode](https://grape.cool/help/write-in-focus-mode): On desktop, give the note you are writing the whole window, or the whole screen: turning focus mode on, full screen, getting back, and its three options.
- [Write on pages](https://grape.cool/help/write-on-pages): Set text notes out on A4 or Letter pages like a document, and how the pages break on desktop and mobile.
- [Write notes by hand](https://grape.cool/help/write-notes-by-hand): Handwriting notes: turning them on, creating one, the tools on the bar and how the pages work on iPad, iPhone, Android and desktop.
- [Choose paper, page size and orientation](https://grape.cool/help/choose-paper-and-page-size): The five rulings, A4 or Letter, portrait or landscape, and where the defaults for new notebooks live.
- [Search your handwriting and ask the AI about it](https://grape.cool/help/search-your-handwriting): How the words on a handwritten page are read on the device, when it happens, what the AI can and cannot do with a notebook, and the limits.
- [Write on a PDF and export a notebook as PDF](https://grape.cool/help/write-on-a-pdf): Import a PDF as pages to annotate, what happens to page size, and how to get a notebook out as a PDF.
- [Create folders and subfolders](https://grape.cool/help/create-folders-and-subfolders): Build a folder tree, nest subfolders, rename and reorder them on desktop and mobile.
- [Tag your notes](https://grape.cool/help/tag-your-notes): Type # to tag a note, and use tags for themes that cut across your folders.
- [Pin a note to the top](https://grape.cool/help/pin-a-note): Keep your d