# WaniKani

> WaniKani is an MCP server for language learning. Read-only MCP server for your WaniKani profile, reviews, assignments and levels. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/jbeshir/mcp-servers/tree/HEAD/wanikani
- **MCP Registry name:** io.github.jbeshir/wanikani-mcp
- **Categories:** [language learning](https://ai-powered.com/categories/language-learning), [education and exams](https://ai-powered.com/categories/education-and-exams)
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

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

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

## Alternatives

- [Bunpro](https://ai-powered.com/mcp/bunpro): Bunpro is a free MCP server for language learning.
- [AnkiMCP Server](https://ai-powered.com/mcp/ankimcp-server): AnkiMCP Server is an open-source MCP server for education and exams.
- [Anki MCP Server](https://ai-powered.com/mcp/anki-mcp-server): Anki MCP Server is a freemium MCP server for education and exams.
- [Moodle MCP](https://ai-powered.com/mcp/moodle-mcp-2): Moodle MCP is an open-source MCP server for education and exams.
- [Canvas Parent MCP](https://ai-powered.com/mcp/canvas-parent-mcp): Canvas Parent MCP is an open-source MCP server for education and exams.
- [Anki MCP](https://ai-powered.com/mcp/anki-mcp): Anki MCP is an open-source MCP server for education and exams.
- [Moodle MCP](https://ai-powered.com/mcp/moodle-mcp): Moodle MCP is an open-source MCP server for education and exams.

---
Source: https://ai-powered.com/mcp/wanikani
