# MAL MCP Server

> MAL MCP Server is an open-source MCP server for events and entertainment. MyAnimeList search, rankings and seasonal data, plus management of your own list. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Repository:** https://github.com/grinv/mal-mcp
- **MCP Registry name:** io.github.Grinv/mal-mcp
- **Categories:** [events and entertainment](https://ai-powered.com/categories/events-and-entertainment), [books and literature](https://ai-powered.com/categories/books-and-literature)
- **Listing updated:** 2026-11-18

## About

This server uses a hybrid backend. Reads such as search, details, rankings, seasons, characters, staff, reviews, news and recommendations come from Tenrai, which the README calls a free, unofficial MyAnimeList API, and need no credentials. Your personal list, profile and statistics use the official MyAnimeList API after a one-time login.

Adding a free MyAnimeList client ID also gives the main read tools a fallback to the official API if Tenrai has an outage. With login you can view your list, add or update entries, change episode counts and remove entries. Included prompts help with recommendations, seasonal overviews and hidden gems, and title suggestions appear as you type in clients that support completion.

It installs through npx or a one-click mcpb bundle and works over stdio with clients such as Claude Desktop, Cursor and VS Code. A sister project covers AniList.

## Features

- **No-signup reads:** Search, rankings, seasons and reviews work immediately.
- **Personal list:** View, update and remove your own entries after login.
- **Outage fallback:** A client ID lets reads retry on the official API.
- **Schedules and news:** Airing schedule and news tools.
- **Random picks:** Random anime, manga, character or person.
- **Built-in prompts:** Similar titles, seasonal overview and hidden gems.

## Good for

- Find an anime's score, studio and synopsis
- Browse the current season by popularity
- Update episode progress on your list
- Get recommendations similar to a favourite

## Install

### Claude Code (Terminal)

```sh
claude mcp add mal-mcp --env MAL_CLIENT_ID='<MAL_CLIENT_ID>' --env MAL_REFRESH_TOKEN='<MAL_REFRESH_TOKEN>' --env MAL_ACCESS_TOKEN='<MAL_ACCESS_TOKEN>' -- npx -y mal-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mal-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mal-mcp"
      ],
      "env": {
        "MAL_CLIENT_ID": "<MAL_CLIENT_ID>",
        "MAL_REFRESH_TOKEN": "<MAL_REFRESH_TOKEN>",
        "MAL_ACCESS_TOKEN": "<MAL_ACCESS_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mal-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mal-mcp"
      ],
      "env": {
        "MAL_CLIENT_ID": "<MAL_CLIENT_ID>",
        "MAL_REFRESH_TOKEN": "<MAL_REFRESH_TOKEN>",
        "MAL_ACCESS_TOKEN": "<MAL_ACCESS_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mal-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mal-mcp"
      ],
      "env": {
        "MAL_CLIENT_ID": "<MAL_CLIENT_ID>",
        "MAL_REFRESH_TOKEN": "<MAL_REFRESH_TOKEN>",
        "MAL_ACCESS_TOKEN": "<MAL_ACCESS_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mal-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mal-mcp"
      ],
      "env": {
        "MAL_CLIENT_ID": "<MAL_CLIENT_ID>",
        "MAL_REFRESH_TOKEN": "<MAL_REFRESH_TOKEN>",
        "MAL_ACCESS_TOKEN": "<MAL_ACCESS_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mal-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mal-mcp"
      ],
      "env": {
        "MAL_CLIENT_ID": "<MAL_CLIENT_ID>",
        "MAL_REFRESH_TOKEN": "<MAL_REFRESH_TOKEN>",
        "MAL_ACCESS_TOKEN": "<MAL_ACCESS_TOKEN>"
      }
    }
  }
}
```

## Tools

- `search_anime`: Searches anime
- `search_manga`: Searches manga
- `get_anime`: Gets anime details
- `get_manga`: Gets manga details
- `get_anime_characters`: Gets anime characters
- `get_anime_recommendations`: Gets anime recommendations
- `get_anime_reviews`: Gets anime reviews
- `get_top_anime`: Gets top anime
- `get_top_manga`: Gets top manga
- `get_seasonal_anime`: Gets seasonal anime
- `get_anime_schedule`: Gets the airing schedule
- `get_my_anime_list`: Gets your anime list
- `update_my_anime_status`: Updates an anime list entry
- `delete_my_anime_list_item`: Deletes an anime list entry
- `login_mal`: Logs in to MyAnimeList

## FAQ

### Do I need an account?

Only for your personal list tools.

### What backend serves reads?

Tenrai, an unofficial MAL API.

### What if Tenrai is down?

With a client ID the main reads retry against the official API.

### How is it installed?

Through npx or an mcpb bundle.

### Is MAL MCP Server free?

Yes. MAL MCP Server is open source, so you can use and self-host it for free.

### How do I add MAL MCP Server to Claude Code?

Run this command in your terminal: claude mcp add mal-mcp --env MAL_CLIENT_ID='<MAL_CLIENT_ID>' --env MAL_REFRESH_TOKEN='<MAL_REFRESH_TOKEN>' --env MAL_ACCESS_TOKEN='<MAL_ACCESS_TOKEN>' -- npx -y mal-mcp

### What are the best alternatives to MAL MCP Server?

The closest alternatives to MAL MCP Server are Dostuff, Comicvine, Countdowns Online MCP, Skiddle and Edmtrain.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Dostuff](https://ai-powered.com/mcp/dostuff): Dostuff is a freemium MCP server for events and entertainment.
- [Comicvine](https://ai-powered.com/mcp/comicvine): Comicvine is a freemium MCP server for books and literature.
- [Countdowns Online MCP](https://ai-powered.com/mcp/countdowns-online-mcp-2): Countdowns Online MCP is an open-source MCP server for events and entertainment.
- [Skiddle](https://ai-powered.com/mcp/skiddle): Skiddle is a freemium MCP server for events and entertainment.
- [Edmtrain](https://ai-powered.com/mcp/edmtrain): Edmtrain is a freemium MCP server for events and entertainment.
- [Luma](https://ai-powered.com/mcp/luma): Luma is a freemium MCP server for events and entertainment.
- [Librivox](https://ai-powered.com/mcp/librivox): Librivox is a freemium MCP server for books and literature.
- [Google Books](https://ai-powered.com/mcp/google-books): Google Books is a freemium MCP server for books and literature.

---
Source: https://ai-powered.com/mcp/mal-mcp-server
