WinkNotes · AI and import

Start with an idea,keep it for reviewChoose the AI you use

Follow a guide to connect, and keep WinkNotes running while you use it.

Connect AI to study with WinkNotes, or start a card from a screenshot, image, or file.

Local MCP setup is done on a Mac, with WinkNotes running.

Example

You

What should I review today? Quiz me on three cards.

One at a time.
First: what is opportunity cost?

Before you start

Open WinkNotes on your Mac

These guides use a local MCP connection. Keep WinkNotes running, then pick the AI client you use and follow its steps.

Connection: stdioNo server URL to fill in

Choose the AI you use

10 illustrated guides

ClaudeOpen setup guide

CodexOpen setup guide

DeepSeek HarnessOpen setup guide

DoubaoOpen setup guide

GrokOpen setup guide

MiniMax CodeOpen setup guide

OpenCodeOpen setup guide

QoderOpen setup guide

WorkBuddyOpen setup guide

ZCodeOpen setup guide

Qwen does not support WinkNotes’ current connection method yet. Pick one of the clients above.

Last step

Have AI read your deck list once

After you save the configuration, reload or start a new session as the client asks, then send this. The connection works only if it can actually call a WinkNotes tool.

Using the WinkNotes MCP tools, call list_packs. Tell me only how many decks there are. Do not change any data.

AI with WinkNotes

Connect your AI first

After you connect, expand one and copy the prompt. These are examples you can use in a connected client now.

制Turn notes into cardsConfirm the content, then create cards

Turn the material below into WinkNotes cards for active recall: one clear question per card, a short accurate answer, and enough context. Show me the cards first, then create them after I confirm.

练Quiz me card by cardFollow up based on my answer

What should I review today? Pick three due WinkNotes cards and quiz me one by one. Wait for my answer before you reveal it.

整Tidy existing cardsFind duplicates, overly broad cards, or missing context

Review the cards in this deck. List duplicates, questions that are too broad, and answers that need more context, with a reason to change each one. Do not edit anything until I confirm.

A full usage guide is still to come. MCP connects on your Mac; the AI client you choose bills its own usage.

Make cards from screenshots and images

In the WinkNotes app

These features already have an entry point. A longer illustrated guide is still to come.

Action ButtonOn iPhones with an Action Button running iOS 26 or later, capture a screenshot to make a card.Open Apple Pencil ProSqueeze Apple Pencil Pro to capture a card. Needs a compatible iPad and iPadOS 26 or later.Open

Built-in screenshot and image-share AI cards are on a limited free trial, then they use credits. WinkNotes does not cache or keep uploaded data; the image is sent to the language model only for this generation.

Import an AI-made deck

Have an AI that supports the card-making Skill generate and check a .wink file, then import it into WinkNotes to start reviewing.

See how to importAI file import stays free. The external AI service may charge on its own. A longer guide is still to come.

Keep exploring

Make cards, quiz, and tidy with AI ↗Connect AI to study with WinkNotes, or generate a deck you can import Study and review ↗How the WinkNotes review cycle works

Data access and help

Once connected, AI can read card text and images, create or edit cards, and record reviews. WinkNotes does not offer a tool to delete cards. Card content the AI reads is sent to the AI you chose. Image cloze provides the unmasked original so the AI can write questions from the full content.

Having trouble connectingOpen on-device diagnostics in the WinkNotes app.

Having trouble connecting? Go back to the matching client guide and check that WinkNotes is running on your Mac.