# Grape

> Grape is an AI note app for Mac, Windows, Linux, iPhone and Android. Record it, write it, then ask your own notes for the answer.

Grape is a downloadable app rather than a web app. Take the note, Grape remembers the rest. The desktop app is on version 0.24.0 for macOS, Windows and Linux, and the mobile app is on version 0.24.0 for iPhone and Android. Notes live in a local database on the user's own device; sync across devices is opt in and only on the paid plans. It is made by Shiny Grape, LLC and support is support@shinygrape.com.

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.

There is no CLI to install and no SDK to import. Every 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.
- Team wikis with shared editing. Grape is a one person library that syncs across the devices that person owns.
- Storing anything you would not put in a local database, such as regulated health or payment records.

## When to use Grape

- [Turn a recording into a searchable note](https://grape.cool/voice-notes): Record a lecture, call or meeting in the app and Grape writes the transcript into the note beside your own words.
- [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 and mind maps out of existing notes rather than from generic web content.
- [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 and only on paid plans.
- [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.
- [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.
- [Search everything published](https://grape.cool/api/v1/search?q=transcription): One term across help articles, posts, features, products, audiences and questions.
- [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, Pro at $19 a month, Lifetime at $29 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.

## What it does

- [AI Agent](https://grape.cool/ai-agent): Chat that reads your library and can act on it
- [Semantic search](https://grape.cool/search): Search that works on what you meant
- [Voice and transcription](https://grape.cool/voice-notes): Meetings and lectures become searchable text
- [Flashcards](https://grape.cool/flashcards): Decks built from the notes you wrote
- [Quizzes](https://grape.cool/quizzes): Test yourself before it counts
- [Mind maps](https://grape.cool/mind-maps): One note laid out as a map
- [Graph view](https://grape.cool/graph-view): How your whole library connects
- [The editor](https://grape.cool/editor): Blocks, tables, images and files
- [Drawing canvas](https://grape.cool/canvas): An infinite canvas inside the note
- [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 on the laptop
- [Backups and history](https://grape.cool/backups): A daily copy of everything, made automatically
- [Desktop and mobile](https://grape.cool/apps): Mac, Windows, Linux, iPhone and Android

## Help center

- [Help center](https://grape.cool/help): All 59 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.
- [Writing and the editor](https://grape.cool/help/category/editor): Formatting, tables, drawings, images, PDFs, templates and everything else a note can hold.
- [Folders and organizing](https://grape.cool/help/category/organize): Folders, subfolders, tags, pinning, sorting 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, 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 and the index behind semantic search.
- [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 or by meaning, and find text inside a note.
- [Study tools](https://grape.cool/help/category/study): Turn any note into flashcards, a quiz or a mind map.
- [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, 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@shinygrape.com.
- [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.

## Optional

- [Solutions index](https://grape.cool/solutions): The same app described for twenty kinds of work.
- [Grape for students](https://grape.cool/students): Lectures in, revision out
- [Grape for researchers](https://grape.cool/researchers): Sources, fieldwork and drafts
- [Grape for teachers](https://grape.cool/teachers): Plans, materials and marking
- [Grape for writers](https://grape.cool/writers): Drafts, research and loose ideas
- [Grape for journalists](https://grape.cool/journalists): Interviews, sources and deadlines
- [Grape for podcasters](https://grape.cool/podcasters): Guests, prep and show notes
- [Grape for designers](https://grape.cool/designers): Research, critique and references
- [Grape for developers](https://grape.cool/developers): Snippets, debugging and decisions
- [Grape for product managers](https://grape.cool/product-managers): Customer calls, specs and context
- [Grape for founders](https://grape.cool/founders): Investors, hiring and everything else
- [Grape for project managers](https://grape.cool/project-managers): Status, risks and follow ups
- [Grape for consultants](https://grape.cool/consultants): Clients, findings and deliverables
- [Grape for lawyers](https://grape.cool/lawyers): Matters, research and attendance notes
- [Grape for therapists](https://grape.cool/therapists): Session notes and reflection
- [Grape for doctors](https://grape.cool/doctors): Learning, teaching and reference
- [Grape for coaches](https://grape.cool/coaches): Client sessions and preparation
- [Grape for marketers](https://grape.cool/marketers): Campaigns, research and copy
- [Grape for sales](https://grape.cool/sales-teams): Calls, accounts and follow ups
- [Grape for real estate agents](https://grape.cool/real-estate-agents): Viewings, listings and clients
- [Grape for freelancers](https://grape.cool/freelancers): Clients, briefs and admin
- [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.
- [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.
- [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.
- [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 or without a subscription.
- [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, 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.
- [Add PDFs to a note](https://grape.cool/help/add-pdfs): Keep the source document in the same note as your notes about it.
- [Add audio files to a note](https://grape.cool/help/add-audio-files): Insert audio you recorded elsewhere on desktop, play it anywhere, and transcribe 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): Search within the open note, step through matches, and the shortcuts that drive it on desktop.
- [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 daily notes at the top of the list on desktop and mobile.
- [Sort and group your notes](https://grape.cool/help/sort-and-group-notes): Choose the sort field and order, and group the list into Today, Yesterday and older sections.
- [Move notes between folders](https://grape.cool/help/move-notes-between-folders): Drag notes on desktop, swipe on mobile, and reorganize without losing anything.
- [Recover a deleted note](https://grape.cool/help/recover-deleted-notes): Where deleted notes go, how to bring one back, and what emptying the folder really deletes.
- [Note info, stats and backlinks](https://grape.cool/help/note-info-and-stats): Word counts, read time, creation dates, and which notes link here.
- [Link notes to each other](https://grape.cool/help/link-notes-together): Connect related notes with internal links, follow them in both directions, and create notes from links.
- [Use graph view](https://grape.cool/help/use-graph-view): See your notes as a connected map, and turn the graph button on in settings.
- [Record a voice note](https://grape.cool/help/record-a-voice-note): Record audio inside a note on desktop or mobile, and keep writing while it runs.
- [Record system audio on desktop](https://grape.cool/help/record-system-audio): Capture a call or a lecture playing on your computer, with or without your microphone.
- [Transcribe a recording or audio file](https://grape.cool/help/transcribe-audio): Turn any recording into text, apply quick prompts to the transcript, and dictate on desktop.
- [Set up AI: Grape AI or your own key](https://grape.cool/help/set-up-ai): The two ways to power the AI features, and which plans include which.
- [Add your own AI models and providers](https://grape.cool/help/add-your-own-ai-models): Enable providers, pick models, and add custom models or an OpenAI compatible endpoint.
- [Run local AI models with Ollama or LM Studio](https://grape.cool/help/use-local-ai-models): Keep AI on your machine with a local model on desktop, and what to expect from it.
- [How note indexing works](https://grape.cool/help/how-indexing-works): What the index is, why semantic search needs it, and what Sync and Regenerate do.
- [Chat with the AI about your notes](https://grape.cool/help/chat-with-the-ai): Open the chat on each platform, pick a model, attach files, and get answers grounded in your notes.
- [Let the AI agent edit and organize your notes](https://grape.cool/help/let-ai-edit-your-notes): What the agent can create, change and move, and the safety net behind every change.
- [Let the AI search the web](https://grape.cool/help/ai-web-search): When the assistant can reach the internet, and which setups support it.
- [Set custom instructions for the AI](https://grape.cool/help/custom-instructions): Pick a base tone and add standing instructions the assistant follows in every chat.
- [Create prompt templates and quick prompts](https://grape.cool/help/prompt-templates): Save the prompts you reuse and run them with one tap from chat and transcriptions.
- [Report an AI answer](https://grape.cool/help/report-an-ai-answer): Flag a response that is wrong or inappropriate, and what happens after you send it.
- [Search your notes](https://grape.cool/help/search-your-notes): Keyword search across the whole library, the shortcut that opens it, and how to narrow results.
- [Search your notes by meaning](https://grape.cool/help/search-by-meaning): AI semantic search finds notes by what they are about, even when the words do not match.
- [Turn a note into flashcards](https://grape.cool/help/create-flashcards): Generate a deck of study cards from any note and review it inside the app.
- [Quiz yourself on a note](https://grape.cool/help/quiz-yourself): Multiple choice quizzes from your own notes, with difficulty levels and an adaptive mode.
- [Create a mind map from a note](https://grape.cool/help/create-mind-maps): Generate a visual map of how the ideas in a note relate, and explore it by expanding branches.
- [Sync your notes across devices](https://grape.cool/help/turn-on-sync): What syncs, when it runs, and what happens to your local database when you sign in.
- [Back up your notes](https://grape.cool/help/back-up-your-notes): Automatic daily backups, manual ones before big changes, and how long each kind is kept.
- [Restore a backup](https://grape.cool/help/restore-a-backup): Roll your library back to a backup, and what to know before you do.
- [Export your notes](https://grape.cool/help/export-your-notes): Get a single note or the whole library out as Markdown, HTML or PDF.
- [Use version history](https://grape.cool/help/use-version-history): Every note keeps its past versions. Preview them, restore one, and know the limits.
- [Delete your data or your account](https://grape.cool/help/delete-your-data-or-account): The two delete options, exactly what each removes, and what each one leaves alone.
- [Change the app language](https://grape.cool/help/change-the-app-language): Grape speaks eight languages, and switching takes two taps in General settings.
- [Change the theme and accent color](https://grape.cool/help/change-theme-and-accent-color): Light, dark or follow the system, plus seventeen accent colors to make it yours.
- [Change the date and time format](https://grape.cool/help/change-date-and-time-format): Pick how every date and time in the app is written, or define your own format.
- [Customize the editor toolbars on desktop](https://grape.cool/help/customize-the-editor-toolbars): The fixed toolbar, the floating selection toolbar and drag handles, each with its own switch.
- [Arrange the desktop panels](https://grape.cool/help/arrange-the-desktop-layout): Resize the four desktop panels, collapse the chat, and keep your layout across devices.
- [Keyboard shortcuts on desktop](https://grape.cool/help/keyboard-shortcuts): Every shortcut the desktop app answers to, from new notes to the hidden snake game.
- [Free, Pro or Lifetime](https://grape.cool/help/choose-a-plan): What each plan includes and which one fits how you work.
- [Manage your subscription](https://grape.cool/help/manage-your-subscription): Change or cancel your plan, and restore a purchase on a new phone.
- [Sign in and sign out](https://grape.cool/help/sign-in-and-sign-out): When you need an account, how signing in works, and what sign out does with local notes.
- [Blog](https://grape.cool/blog): Longer pieces about note taking, AI and building the app.
- [Google Keep Alternative for Students](https://grape.cool/blog/google-keep-alternative-for-students): Google Keep is already in Chrome. Grape keeps that speed, then the notes work on any laptop and turn into revision.
- [GoodNotes Alternative for Students](https://grape.cool/blog/goodnotes-alternative-for-students): GoodNotes is the best paper on an iPad. Grape is what you use when the notes have to leave the tablet and turn into revision.
- [Apple Notes Alternative for Students](https://grape.cool/blog/apple-notes-alternative-for-students): Apple Notes is already on your phone. Grape keeps that simplicity, then the notes work on any laptop and turn into revision.
- [OneNote Alternative for Students](https://grape.cool/blog/onenote-alternative-for-students): OneNote came free with your account. Grape is local first, with AI over your notes, transcription and flashcards built in.
- [Obsidian Alternative for Students](https://grape.cool/blog/obsidian-alternative-for-students): Obsidian is a vault you assemble. Grape is local first too, with AI, lecture transcription and flashcards already built in.
- [Notion Alternative for Students](https://grape.cool/blog/notion-alternative-for-students): Notion is built for systems. Grape is built for studying: lecture recordings, AI chat over your notes, and one tap flashcards.
- [Flashcards From Your Own Notes](https://grape.cool/blog/flashcards-from-your-own-notes): Turn any note into a deck of ten cards on Mac, Windows, Linux, iPhone and Android. Same note, same deck on every device.
- [Grape Mobile is in Beta](https://grape.cool/blog/grape-mobile-is-in-beta): Grape Mobile beta is now available on TestFlight. Download it today and help improve the app with your feedback.
- [Import Apple Notes into Grape](https://grape.cool/blog/import-apple-notes-into-grape): Bring all your Apple Notes into Grape in seconds. Folders, notes, and media are imported in the same order.
- [Grape Desktop is in Beta](https://grape.cool/blog/grape-desktop-is-in-beta): Grape Desktop beta is out for macOS & Windows. The AI note taking app with semantic search & in-app AI chat.