WaniKani
WaniKani is a spaced-repetition learning platform for studying Japanese radicals, kanji, and vocabulary.
Verdict
Common use cases
- Check which kanji reviews are due today
- Analyze retention rates across vocabulary levels
- Surface recent study notes for revision
- Track level progression over the past month
- Generate daily study reminders with pending assignments
Integration
- Vendor
- WaniKani
- Category
- other
- Auth
- API_KEY
- Tools
- 16
- Composio slug
wanikani
Tools
- Create Study Material
Create the sole study-material record for a subject, optionally with notes or meaning synonyms. WaniKani provides no delete endpoint, so creation cannot be undone through the API.
- Get Assignments
Retrieve one assignment by ID, or list the connected user's assignments using progress, availability, level, subject, and update filters.
- Get Level Progressions
Retrieve one level-progression record by ID, or list the user's level history with ID and update-time filters.
- Get Resets
Retrieve one account-reset record by ID, or list account level-reset history.
- Get Reviews
Retrieve one completed review by ID, or list completed reviews filtered by review IDs, subject IDs, or update time.
- Get Review Statistics
Retrieve one per-subject review statistic by ID, or list answer totals, streaks, and accuracy using subject and percentage filters.
- Get Spaced Repetition Systems
Retrieve one spaced-repetition system by ID, or list SRS definitions and their stage intervals.
- Get Study Materials
Retrieve one study-material record by ID, or list the user's subject notes and meaning synonyms with subject and update filters.
- Get Study Summary
Get lessons available now and review availability over the next 24 hours for the connected user.
- Get Subjects
Retrieve one WaniKani subject by ID, or search radicals, kanji, vocabulary, and kana vocabulary by IDs, types, slugs, levels, visibility, or update time.
- Get User
Get the connected user's identity, level, subscription status, vacation state, and application preferences.
- Get Voice Actors
Retrieve one WaniKani pronunciation voice actor by ID, or list voice actors with ID and update-time filters.
- Start Assignment
Irreversibly mark one unlocked lesson assignment as started and move it into reviews. Use only after the user explicitly confirms the exact assignment.
- Submit Review
Irreversibly submit a completed review, changing assignment progress and review statistics. Use only with exact answer counts explicitly confirmed by the user.
- Update Study Material
Update at least one note or meaning-synonym field on an existing study-material record without changing its subject.
- Update User Preferences
Update one or more supported WaniKani lesson or review preferences. Omitted preferences remain unchanged.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Find WaniKani in the MCP directory and click Connect. 3. You'll be prompted to paste your WaniKani API token — generate one by logging into WaniKani, visiting Settings > API Tokens, and creating a personal access token with read and write permissions. 4. Paste the token into Switchy and click Authorize. 5. Once connected, open any Project and type '@WaniKani get assignments' to confirm the integration works — you should see a list of your current study assignments. 6. To invoke other tools, @mention WaniKani in a message and describe what you need (e.g. 'show me my review statistics for the past week').
What teammates see: by default, memories from WaniKani are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Today's Study Queue
@WaniKani get my assignments that are available now and group them by subject type (radical, kanji, vocabulary). Tell me how many of each I need to review today.
Weekly Progress Report
@WaniKani show me my level progressions and review statistics from the last week. Summarize how many reviews I completed, my accuracy rate, and whether I leveled up.
Struggling Vocabulary
@WaniKani get my review statistics and filter for subjects where my percentage correct is below 70%. List the vocabulary or kanji I'm struggling with most.
Add Study Notes
@WaniKani create study material for the kanji '猫' (cat) with the meaning synonym 'feline' and the note 'Think of a cat's whiskers forming the radical.' Confirm it saved.
Review History Snapshot
@WaniKani get all reviews I completed in the past 30 days and show me a breakdown by week. How many days did I skip, and what was my busiest study day?
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@WaniKani show me my current assignments for level 12, filtered by lessons available today
Retrieved 23 assignments for level 12. 8 lessons are available now: 5 kanji (including 働, 勉, 説) and 3 vocabulary items (勉強, 働く, 説明). 15 reviews are scheduled later today between 14:00 and 18:00 UTC. All items are in the 'apprentice' or 'guru' SRS stages. Use the assignment IDs to drill into individual subject details or to cross-reference with your review statistics.
This example shows read-only assignment retrieval with availability and level filters. Requires a valid API key with read:assignments scope. WaniKani's assignment data reflects the user's subscription tier and current study queue; results will be empty if no lessons are unlocked at the requested level.
@WaniKani create a study material for subject 2501 with the meaning synonym 'to labor' and a note reminding me it's similar to 動く
Created study material for subject 2501 (働). Added meaning synonym 'to labor' and stored your note: 'Similar to 動く (to move) — both involve action, but 働く is specifically about working.' This is now the sole study-material record for this subject. WaniKani provides no delete endpoint, so you can only update this record going forward; creation cannot be undone via the API.
Demonstrates the write-only Create Study Material tool. Requires write:study_materials scope. Critical limitation: WaniKani enforces one study-material record per subject and offers no API deletion, so this action is permanent. Use cautiously when automating bulk synonym additions.
@WaniKani pull my review statistics for all kanji subjects where my meaning accuracy is below 75%, then draft a focused study plan
Found 12 kanji with meaning accuracy under 75%: 働 (67%), 勉 (71%), 説 (58%), and 9 others. Common pattern: you're confusing visually similar radicals (e.g., 言 vs 讠). Recommended plan: (1) Review the radical breakdowns for these 12 kanji in your next session. (2) Create meaning mnemonics that emphasize the differing components. (3) Space these reviews across 3 days to avoid cognitive overload. Track progress by re-querying statistics after 10 additional reviews per item.
Synthesis example pairing review-statistics retrieval with AI reasoning. The MCP fetches raw accuracy percentages and streak data; the AI identifies patterns and proposes a study strategy. Requires read:review_statistics scope. Note that WaniKani's statistics lag by ~1 hour after reviews are completed.
Use-case deep-dives
When WaniKani works for a distributed team's Japanese study group
A 6-person remote team runs a voluntary Japanese study group and wants shared visibility into who's keeping up with their kanji reviews. WaniKani's MCP is the right call here because the Get Assignments and Get Review Statistics tools let you pull each member's progress into a shared Switchy workspace without manual screenshot sharing. One person sets up a weekly digest that surfaces who's fallen behind on reviews or hit a new level, and the group uses it to coordinate study sessions. The threshold: this only works if everyone's comfortable sharing their API keys and progress data. If your team treats language learning as private, stick to self-reported check-ins instead of automated tracking.
WaniKani MCP shines for analyzing your own retention patterns
You're a solo learner who's been using WaniKani for 18 months and want to understand why certain kanji keep failing reviews. The Get Review Statistics and Get Spaced Repetition Systems tools let you export your accuracy data and SRS stage history into Switchy, then ask an AI to spot patterns across subjects or time windows. This is a strong fit because WaniKani's web dashboard doesn't surface cross-subject retention analysis, and the 16-tool MCP gives you full read access to your learning history. The buying call: if you're already paying for WaniKani and want to go deeper than the built-in stats, this MCP turns your review data into a queryable dataset without writing Python scripts.
When tutors use WaniKani MCP to tailor lesson plans
A freelance Japanese tutor works with 4 students who all use WaniKani and wants to prep weekly lessons based on what each student reviewed that week. The Get Reviews and Get Assignments tools let the tutor pull recent activity into Switchy and generate personalized vocab drills or grammar exercises that reinforce the kanji each student just learned. This works because the tutor can batch-query all four students' progress in one workspace instead of logging into four separate WaniKani accounts. The constraint: students must share their API keys, and the tutor needs to respect that this data shows struggle points and failure rates. If your students aren't comfortable with that transparency, manual progress reports are the safer route.
Frequently asked
What does the WaniKani MCP do in Switchy?
It pulls your Japanese kanji and vocabulary study data—assignments, reviews, level progress, and custom study notes—into Switchy's workspace. Your team can query review statistics, check SRS stage intervals, and retrieve answer accuracy without opening WaniKani. Useful for language-learning teams tracking progress or building study dashboards.
Do I need a paid WaniKani account to connect the MCP?
You need a WaniKani API key, which requires any active subscription tier. Free trial accounts can generate keys. The MCP reads your personal study data, so each team member connects their own account—there's no shared admin setup. Paste your API key into Switchy's auth flow and you're done.
Can the WaniKani MCP start new reviews or lessons?
No. It reads completed reviews, assignments, and progress history but cannot queue new lessons or submit review answers. WaniKani's API is read-only except for study materials—the MCP can create custom notes and meaning synonyms, but that action is permanent because WaniKani offers no delete endpoint.
How is this different from just using WaniKani's dashboard?
The dashboard shows your current queue and SRS stages; the MCP lets you query historical data and cross-reference it with other tools in Switchy. If you're building study reports, tracking team learning velocity, or feeding review stats into another workflow, the MCP saves you from manual exports or screen-scraping.
Who on the team should connect the WaniKani MCP?
Anyone studying Japanese who wants their progress visible in Switchy. Each connection is personal—your API key only exposes your own reviews and assignments. If you're a team lead tracking learner progress, ask each member to connect their account so you can aggregate stats across the workspace.