MAL MCP Server
by grinvio.github.Grinv/mal-mcpv0.10.0
MyAnimeList MCP server: Tenrai-powered reads plus official MAL personal-list management.
context tax
queued
security
queued
cold start
queued
freshness
Maintained46d ago
Install MAL MCP server
Install in Claude Code
claude mcp add mal -e MAL_CLIENT_ID='<mal-client-id>' -e MAL_REFRESH_TOKEN='<mal-refresh-token>' -e MAL_ACCESS_TOKEN='<mal-access-token>' -- npx -y mal-mcpInstall in Cursor
{
"mcpServers": {
"mal": {
"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 (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"mal": {
"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>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"mal": {
"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 .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"mal": {
"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.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| MAL_CLIENT_ID | — | yes | MAL app Client ID (type 'other'). Also enables read-tool resilience with no login. See docs/auth.md. |
| MAL_REFRESH_TOKEN | — | yes | OAuth refresh token (one-time auth, docs/auth.md); enables personal-list tools with auto-refresh. |
| MAL_ACCESS_TOKEN | — | yes | Advanced: standalone MAL access token. Works ~30 days without refresh; usually leave unset. |
Freshness
Maintained — last maintenance signal 46d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-08-24 · 46d ago · GitHub
Latest release
2026-08-24 · 46d ago · GitHub · v0.10.0
Package published
no data · npm/PyPI
Registry entry updated
2026-08-24 · 46d ago · official registry · v0.10.0
FAQ
›How do I install the MAL MCP server in Claude Code?
Run: claude mcp add mal -e MAL_CLIENT_ID='<mal-client-id>' -e MAL_REFRESH_TOKEN='<mal-refresh-token>' -e MAL_ACCESS_TOKEN='<mal-access-token>' -- npx -y mal-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does MAL require an API key?
Yes. It expects MAL_CLIENT_ID, MAL_REFRESH_TOKEN, MAL_ACCESS_TOKEN, of which 3 are secrets.
›Can I use MAL as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is MAL in the official MCP registry?
Yes, as io.github.Grinv/mal-mcp.