MAL MCP Server
MyAnimeList search, rankings and seasonal data, plus management of your own list
- Pricing
- Open source
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 0.11.0
- Listing updated
- today
Similar MCP servers
About MAL MCP Server
MAL MCP Server is an open-source MCP server for events and entertainment. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a 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-mcpAdd to claude_desktop_config.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>"
}
}
}
}Add to ~/.cursor/mcp.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>"
}
}
}
}Add to .vscode/mcp.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>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.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>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"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>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
MAL_CLIENT_IDMAL app Client ID (type 'other'). Also enables read-tool resilience with no login. See docs/auth.md.MAL_REFRESH_TOKENOAuth refresh token (one-time auth, docs/auth.md); enables personal-list tools with auto-refresh.MAL_ACCESS_TOKENAdvanced: standalone MAL access token. Works ~30 days without refresh; usually leave unset.MAL_CLIENT_IDMAL app Client ID (type 'other'). Also enables read-tool resilience with no login. See docs/auth.md.MAL_REFRESH_TOKENOAuth refresh token (one-time auth, docs/auth.md); enables personal-list tools with auto-refresh.MAL_ACCESS_TOKENAdvanced: standalone MAL access token. Works ~30 days without refresh; usually leave unset.
Tools this server provides (15)
Taken from the project documentation; the running server may differ.
- 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
What it does
- 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
Pricing
Open source
Open source
MAL MCP Server 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.

