MAL MCP Server MCP Server

Name: MAL MCP Server MCP Server
Author: io.github.Grinv

io.github.Grinv/mal-mcp

Repository Registry

What is the MAL MCP Server MCP server?

MyAnimeList MCP server: Tenrai-powered reads plus official MAL personal-list management.

How to install MAL MCP Server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

MAL_CLIENT_ID
secret
MAL app Client ID (type 'other'). Also enables read-tool resilience with no login. See docs/auth.md.
MAL_REFRESH_TOKEN
secret
OAuth refresh token (one-time auth, docs/auth.md); enables personal-list tools with auto-refresh.
MAL_ACCESS_TOKEN
secret
Advanced: standalone MAL access token. Works ~30 days without refresh; usually leave unset.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

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

Cursor

~/.cursor/mcp.json

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

Windsurf

~/.codeium/windsurf/mcp_config.json

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

VS Code

.vscode/mcp.json

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

Claude Code

claude mcp add mal-mcp --env MAL_CLIENT_ID=<YOUR_MAL_CLIENT_ID> --env MAL_REFRESH_TOKEN=<YOUR_MAL_REFRESH_TOKEN> --env MAL_ACCESS_TOKEN=<YOUR_MAL_ACCESS_TOKEN> -- npx -y mal-mcp

Related MCP servers

TMDB MCP Server

Active

MCP server for The Movie Database (TMDB) with IMDb/Rotten Tomatoes/Metacritic ratings via OMDb.

TypeScript

MIT

View repository →

AniList MCP Server

Active

MCP server for the AniList GraphQL API — anime/manga search, details, and personal list management.

TypeScript

MIT

View repository →

Steam MCP Server

Active

Steam store/game data (no key) plus player profiles, libraries and achievements (Steam Web API).

TypeScript

MIT

View repository →