WaniKani
Read-only MCP server for your WaniKani profile, reviews, assignments and levels
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 1.0.1
- Listing updated
- 4 days ago
Similar MCP servers
About WaniKani
WaniKani is an MCP server for language learning. It runs locally on your machine and is started by your AI client.
WaniKani teaches Japanese kanji and vocabulary through spaced repetition, and this server gives an assistant read access to the learner's own progress. It is written in Go on mcp-go, runs locally over stdio and talks to the WaniKani v2 API with a personal access token set in WANIKANI_API_KEY.
The README explains the concepts the tools return: radicals, kanji, vocabulary and kana vocabulary as subjects; assignments that hold each subject's SRS stage from 0 (initiate) to 9 (burned); and levels 1 to 60. Collection tools are paginated automatically, capped by a limit that defaults to 500 and can go to 10,000, and responses begin with a "Showing N of M" line so the client knows if results were truncated.
All six tools are read-only, so an assistant can analyse study data but cannot submit reviews. It is packaged as an MCPB bundle and can also be built with go install.
Install
Run in a terminal
claude mcp add wanikani-mcp --env WANIKANI_API_KEY='<WANIKANI_API_KEY>' -- npx -y https://github.com/jbeshir/mcp-servers/releases/download/wanikani-v1.0.1/wanikani-mcp.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"wanikani-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/jbeshir/mcp-servers/releases/download/wanikani-v1.0.1/wanikani-mcp.mcpb"
],
"env": {
"WANIKANI_API_KEY": "<WANIKANI_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"wanikani-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/jbeshir/mcp-servers/releases/download/wanikani-v1.0.1/wanikani-mcp.mcpb"
],
"env": {
"WANIKANI_API_KEY": "<WANIKANI_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"wanikani-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/jbeshir/mcp-servers/releases/download/wanikani-v1.0.1/wanikani-mcp.mcpb"
],
"env": {
"WANIKANI_API_KEY": "<WANIKANI_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"wanikani-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/jbeshir/mcp-servers/releases/download/wanikani-v1.0.1/wanikani-mcp.mcpb"
],
"env": {
"WANIKANI_API_KEY": "<WANIKANI_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"wanikani-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/jbeshir/mcp-servers/releases/download/wanikani-v1.0.1/wanikani-mcp.mcpb"
],
"env": {
"WANIKANI_API_KEY": "<WANIKANI_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
WANIKANI_API_KEYWaniKani API token from wanikani.com/settings/personal_access_tokensRequired
Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- get_user
- Gets the user's profile including level, subscription and vacation status.
- get_summary
- Gets available lessons and reviews grouped by hour.
- get_assignments
- Gets SRS assignments tracking progress on subjects.
- get_subjects
- Gets radicals, kanji and vocabulary with meanings, readings and mnemonics.
- get_review_statistics
- Gets review accuracy statistics per subject.
- get_level_progressions
- Gets level progression history with timestamps.
What it does
- Profile and subscription
- Returns the user's level, subscription and vacation status.
- Lesson and review schedule
- Summarises available lessons and reviews grouped by hour.
- SRS assignments
- Filters progress by subject type, level, SRS stage and availability.
- Subject lookup
- Fetches radicals, kanji and vocabulary with meanings, readings and mnemonics.
- Review statistics
- Reports correct and incorrect counts, streaks and accuracy thresholds per subject.
- Level history
- Lists level progressions with timestamps.
Good for
- Ask which kanji you keep getting wrong
- See what reviews are due in the coming hours
- Review how long each level took you
- Look up readings and mnemonics for a subject during study chat
WaniKani FAQ
What do I need to run it?
A WaniKani API token from wanikani.com/settings/personal_access_tokens, set as WANIKANI_API_KEY.
Can it submit reviews or change my data?
No. All tools are read-only.
How many results does it return?
Collection tools default to 500 results and accept a limit up to 10,000, with a header showing how many were returned out of the total.
Which clients does the README show?
Claude Desktop and Claude Code configuration examples.
How do I install it?
Download a release binary, use go install, or build with make build.
How do I add WaniKani to Claude Code?
Run this command in your terminal: claude mcp add wanikani-mcp --env WANIKANI_API_KEY='<WANIKANI_API_KEY>' -- npx -y https://github.com/jbeshir/mcp-servers/releases/download/wanikani-v1.0.1/wanikani-mcp.mcpb
What are the best alternatives to WaniKani?
The closest alternatives to WaniKani are Bunpro, AnkiMCP Server, Anki MCP Server, Moodle MCP and Canvas Parent MCP.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.