Skip to content

HanyuGuide · AI connections

Your Chinese study, in the AI you already use.

Bring your HanyuGuide study context and vocabulary lists into Claude or ChatGPT. Ask for focused practice, save new words, and organize your lists in conversation.

See how to connect
Try asking · Claude / ChatGPT
“Use HanyuGuide to read my travel list. Write a short café conversation using those words, then quiz me one line at a time.”

一起练习。

See it working

Ask in plain words. HanyuGuide does the rest.

These conversations use the real HanyuGuide connection tools and live dictionary results. Your assistant reads, writes, and explains; HanyuGuide supplies the dictionary, your study history, and your lists.

For teachers

Snap a worksheet. Get a study list.

Photograph a textbook page or handout and ask for a list. Your assistant reads the words, matches each one to the HanyuGuide dictionary, and saves them all in one step. A whole unit’s vocabulary is ready before class instead of after an evening of typing.

  • Works with textbook pages, handouts, and whiteboard photos
  • Every word is matched to a real dictionary entry, never guessed
  • Assign the finished list to your class from Classrooms
Claude HanyuGuide connected

Make a HanyuGuide list called “Unit 3: Food” with every word on this worksheet.

Looked up 8 words in the dictionary

Result · dictionary_entries

{"status":"found","id":10519,"word":"苹果","pinyin":"píng guǒ","hsk_v2_level":1}
{"status":"found","id":9554,"word":"米饭","pinyin":"mǐ fàn","hsk_v2_level":1}
{"status":"found","id":12941,"word":"面条","pinyin":"miàn tiáo","hsk_v2_level":3}
… 5 more found
Created the list “Unit 3: Food”
Added 8 words to the list

Done. I created “Unit 3: Food” and added all 8 words from the worksheet:

Unit 3: Food 8
苹果
píng guǒ apple
米饭
mǐ fàn cooked rice
面条
miàn tiáo noodles
牛奶
niú nǎi milk
茶
chá tea
饺子
jiǎo zi dumplings
好吃
hǎo chī tasty
喜欢
xǐ huan to like

The list is ready to study in HanyuGuide. To share it with students, assign it to your class from your classroom page.

For learners

A story made from your own words.

Your assistant asks HanyuGuide which words you studied recently and which ones you keep missing, then writes a short story you can actually read. No more texts full of words you have never seen.

Claude HanyuGuide connected

Write me a very short story using the words I’m learning on HanyuGuide. Add pinyin.

Found 6 words you are learning

Result · story_seed_words

{"id":3748,"word":"喜欢","pinyin":"xǐ huan","hsk_v2_level":1}
{"id":12736,"word":"饺子","pinyin":"jiǎo zi","hsk_v2_level":4}
{"id":12725,"word":"饭馆","pinyin":"fàn guǎn","hsk_v2_level":1}
… 3 more

Here is a short story with six of your words, highlighted:

小明xiǎo míng很hěn喜欢xǐ huan吃chī饺子jiǎo zi。今天jīn tiān他tā和hé妈妈mā ma去qù饭馆fàn guǎn。服务员fú wù yuán问wèn:“你们nǐ men想xiǎng喝hē什么shén me?”小明xiǎo míng说shuō:“我wǒ要yào一杯yì bēi牛奶niú nǎi。”妈妈mā ma说shuō:“我wǒ喝hē茶chá。”饺子jiǎo zi很hěn好吃hǎo chī,小明xiǎo míng吃了chī le二十个èr shí gè!

Translation

Xiao Ming really likes eating dumplings. Today he goes to a restaurant with his mom. The waiter asks, “What would you like to drink?” Xiao Ming says, “I’d like a glass of milk.” Mom says, “I’ll have tea.” The dumplings are delicious, and Xiao Ming eats twenty!

Want me to quiz you on it one sentence at a time?

For review

Practice the words that keep slipping.

HanyuGuide knows which reviews you keep getting wrong. Ask for a quick quiz and your assistant starts with exactly those words, then explains each mistake.

Connect your AI
Claude HanyuGuide connected

Which words am I struggling with? Quiz me.

Checked your 3 most difficult words

Result · difficult_words

{"id":133848,"word":"喝","pinyin":"hē","definitions":["to drink"]}
{"id":3432,"word":"吃","pinyin":"chī","definitions":["to eat"]}
{"id":12941,"word":"面条","pinyin":"miàn tiáo","definitions":["noodles"]}

Your trickiest words right now are 喝 hē (to drink), 吃 chī (to eat), and 面条 miàn tiáo (noodles). First question: how do you say “I want to drink tea”?

我要吃茶。

Close! Use 喝 for drinks and 吃 for food: 我要喝茶。 Next one: what does 面条 mean?

Less setup. More useful practice.

Practice with context

Ask your assistant to use your recent study context and list contents to create dialogues, explanations, and quizzes.

Turn a conversation into a study list

Look up dictionary words and add them to a personal list together, ready for your next HanyuGuide review.

Tidy up lists in one request

Create, rename, reorder, archive, or restore personal lists. Move and remove words in batches instead of editing them one by one.

Connect your account

You need a HanyuGuide account; creating one is free. Editing lists requires full study access in HanyuGuide.

Claude

HanyuGuide is listed in Claude’s connector directory. Open the listing, choose Connect, and sign in to HanyuGuide to approve access.

Open HanyuGuide in Claude’s directory

ChatGPT

HanyuGuide is available as a ChatGPT plugin. Open the plugin page, add it to ChatGPT, and sign in to HanyuGuide to approve access.

Open HanyuGuide in ChatGPT

What HanyuGuide adds to your assistant

The connection gives your assistant the tools below. It decides when to call one from what you ask, and most AI apps show each call in the conversation. HanyuGuide only answers those calls; it never sees the rest of your conversation.

Dictionary and practice

Read only. Free with any HanyuGuide account.

dictionary_search
Find words by characters, pinyin, or English meaning.
dictionary_entry
Meanings, readings, examples, and related words for one word.
dictionary_entries
Look up to 20 words at once.
pinyin_convert
Add tone-mark pinyin to Chinese text.
character_strokes
How a character is built and the order of its strokes.
hsk_quiz_words
Random official HSK words with answer choices for a quiz.

Your study

Read only.

recently_studied_words
The words you studied most recently.
difficult_words
The words you keep getting wrong in reviews.
study_summary
Words studied, reviews this week, and reviews due now.
story_seed_words
A mix of recent and difficult words for a story or dialogue.
study_lists
Your personal study lists.
study_list_words
The words in your personal lists.

List changes

Only when you ask. Needs list permission and full study access.

add_words_to_study_lists
Add dictionary words to one or more lists.
add_word_to_study_list
Add one word to one list.
remove_words_from_study_lists
Remove words from lists. Your study progress stays.
move_study_list_words
Move words from one list to another.
manage_study_lists
Create, rename, archive, or restore lists.
reorder_study_lists
Change the order of your lists.

No tool can change your study progress, settings, or billing, or permanently delete a list.

Example prompts

Mention HanyuGuide in your request so your assistant knows to use it.

  • “Use HanyuGuide to look up 银行 and 行走. Why is 行 read differently in each?”
  • “Quiz me on 10 HSK 3 words from HanyuGuide, one at a time.”
  • “Which HanyuGuide words am I struggling with? Write five practice sentences with them.”
  • “Write a short story with pinyin using the words I’m learning on HanyuGuide.”
  • “Add 咖啡, 茶 and 牛奶 to a HanyuGuide list called “Drinks”.”

Troubleshooting

My assistant does not use HanyuGuide.
Turn HanyuGuide on for the conversation in your AI app’s connectors or tools menu, and mention HanyuGuide in your request.
Sign-in or authorization fails.
Start a fresh connection from your AI app instead of reopening an old authorization page, and sign in to the HanyuGuide account you want to connect.
List changes fail because a permission is missing.
Disconnect HanyuGuide in your AI app, connect again, and approve list access on the HanyuGuide permission page.
List changes say a plan is needed.
Editing lists needs full study access in HanyuGuide. The dictionary, pinyin, stroke, and HSK quiz tools stay free with any account.
The assistant says it is rate limited.
Wait a minute, then try again. One request with many words works better than many small requests.
A word is not found or has no meaning.
Some words are not in the HanyuGuide dictionary yet. Check the characters or search by pinyin. Your assistant should tell you rather than make up a meaning.
The assistant changed a list by mistake.
Email us the list name and roughly when it happened. Every list change made through the connection is recorded, so we can undo it.

You choose the access.

Sign in on HanyuGuide and review permissions before connecting. Your assistant can read study context and, with your approval and full study access, manage personal lists. These tools cannot change your billing, account preferences, or study progress.

Information returned by the connection is shared with the AI provider you choose. Review proposed list changes before approving them, and disconnect HanyuGuide in your AI app when you no longer want to use it.

Privacy and your data

  • HanyuGuide receives only the tool requests your assistant sends, such as a word to look up or a list to change. We do not receive your conversation, your assistant’s memory, or files you share with it.
  • We use those requests to answer them and to apply rate limits, never for advertising.
  • We keep a record of each connection you approve and of each list change made through it, so we can undo mistakes. Both are deleted when you delete your account.
Read the privacy policy

Help and security

For help with the connection, or to report a security problem, email hey@hanyuguide.com. Tell us which AI app you use, what you asked, and roughly when. We can also disconnect your assistant for you.

What about other AI apps?

HanyuGuide is in Claude’s connector directory and available as a ChatGPT plugin. Other AI apps that support MCP connectors with OAuth sign-in can use the server URL below. We’ll add setup guides for more apps here as we verify each connection.

Server URL — paste this into your AI app

https://hanyuguide.com/mcp/hanyuguide-user