Skip to content
MCP server

WaniKani

Read-only MCP server for your WaniKani profile, reviews, assignments and levels

Runs locally
Install
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.mcpb

Add 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.

How AIPoweredBot checks servers