Guide
Shortcuts, Siri and AI assistants
KTdict works beyond its own window. Ask Siri, build your own shortcuts, find your flashcards in Spotlight, and let AI assistants on your Mac work with your dictionary, flashcards and reader.
Siri and ready-made shortcuts
KTdict adds its own shortcuts as soon as it's installed. You don't need to set anything up: say one of these phrases to Siri, or find them in Spotlight and the Shortcuts app on iPhone, iPad and Mac.
| Shortcut | Say, for example |
|---|---|
| Search Dictionary | “Look up a word in KTdict” |
| Add Flashcard | “Add a flashcard in KTdict” |
| Search History | “Show my KTdict history” |
| Start Training | “Start training in KTdict” |
| Quiz Me | “Quiz me in KTdict” |
| Training Progress | “How many KTdict cards are left” |
Quiz Me runs entirely inside Siri: it shows the next card of today's training set, you reveal the solution and say whether you knew it, all without opening KTdict.
The training shortcuts need KTdict Deluxe.
All actions in the Shortcuts app
In the Shortcuts app, search for “KTdict” to see every action. Most of them run in the background and hand their result to the next step, so they can be combined with other apps' actions.
| Area | Actions |
|---|---|
| Dictionary | Search Dictionary (English, German, French, Pinyin or Chinese) · Open KTdict and Search · Open Word · Get Search History · Delete Search History |
| Flashcards | Add Flashcard · Add Words as Flashcards (one card per new word in a Chinese text) · Edit Flashcard · Delete Flashcards · Open Flashcard |
| Training | Start Training · Quiz Me · Get Training Progress |
| Reader | Add Reader Document (text or image) · Import Web Page into Reader · Open Reader Document |
| Text tools | Get Pinyin · Translate Chinese Text · Speak Chinese Text · Simplify Chinese Text |
Translate Chinese Text uses Apple's on-device translation. If it asks for languages, download Chinese and your dictionary language in the Translate settings. Simplify Chinese Text rewrites a text in easier Chinese with Apple Intelligence; it needs iOS 27 or macOS 27 and a device that supports Apple Intelligence.
Ideas for your own shortcuts
- Pinyin for anything: a shortcut that receives text from the share sheet, runs Get Pinyin and shows the result. Select Chinese text in any app, share it, and read it with Pinyin.
- Vocabulary from an article: share a web page, run Get Article using Safari Reader and Add Words as Flashcards into a group named after the article. Every word you don't have yet becomes a flashcard.
- A daily quiz: in the Shortcuts app, create a personal automation at a time of day that runs Quiz Me.
- Listen while you read: run Speak Chinese Text on copied text to hear it with the voice you chose in KTdict.
Spotlight
Your flashcards and reader documents appear in Spotlight search. Type a word or a document title, and open the result straight in KTdict.
AI assistants on the Mac (MCP)
KTdict for Mac has a built-in MCP server. MCP (Model Context Protocol) is the standard that AI assistants such as Claude and ChatGPT use to work with other apps. With it, an assistant can look up words in KTdict's dictionary, read and tidy your search history, create and edit flashcards, and add documents to your reader.
Start the server
- Open KTdict on your Mac and choose KTdict › Settings…, then the MCP tab.
- Click Start. The status changes to “Local MCP server running”.
- Keep KTdict open while you use an assistant. Connections pause when KTdict quits and resume when you open it again.
Claude for Mac
In the MCP settings, choose Claude and click Add to Claude. Claude for Mac opens and asks you to confirm. There's nothing else to configure; clicking again later simply updates the extension.
ChatGPT for Mac
- In the MCP settings, choose ChatGPT and copy the command shown there.
- In ChatGPT for Mac, open Settings › Plugins › Add, then choose Add MCP Server.
- Name it KTdict, choose STDIO, and paste the command. Leave the arguments empty.
- Save, then start a new chat.
Claude Code, Codex and other clients
Choose Other AI assistants in the MCP settings. There are two ways to connect:
stdio (recommended): add the command shown in the settings as a local MCP server, without arguments. The settings also show ready-to-paste commands for Claude Code and Codex, in this form:
claude mcp add ktdict -- "<command from KTdict's settings>"
HTTP: add the address shown in the settings as a remote MCP server, and use the bearer token for authentication. Stopping and starting the server issues a new token; relaunching KTdict keeps it.
What assistants can do
| Area | Tools |
|---|---|
| Dictionary | Search in English, German, French, Pinyin or Chinese; get a word's full entry |
| History | List your search history; delete entries or all of it |
| Flashcards | List groups and cards, add, edit and delete flashcards |
| Reader | List and read documents; add text or an image (for OCR); delete documents |
| App | Open KTdict with a search, a reader document, or a web page to import |
Things to ask
- “Make flashcards for the new words in this text and put them in a group called Lesson 5.”
- “Which words did I look up this week? Make a short story that uses them.”
- “Check my flashcards for wrong or missing Pinyin and fix them.”
- “Import this article into my KTdict reader: https://…”
Privacy
The server only accepts connections from your own Mac and requires a token, so other devices on your network can't reach it. Your data stays in KTdict until an assistant uses one of its tools. The result of that tool, for example the flashcards it listed, is then sent to the assistant's provider like the rest of your conversation. Only connect assistants you trust with that data, and stop the server in KTdict's settings when you don't need it.