MyAnimeList MCP Server

MCP Server for interacting with the MyAnimeList API, allowing LLM clients to access and interact with anime, manga and more.

Using with Claude Desktop (or other MCP clients)

Manual Installation

1. Add this server to your claude_desktop_config.json:

{
    "mcpServers": {
        "myanimelist": {
            "command": "uv",
            "args": [
                "--directory",
                "<path to your project>",
                "run",
                "main.py"
            ]
        }
    }
}

2. Restart Claude Desktop
3. Use the tools to interact with MyAnimeList

Available Tools

Anime

• get_anime: Get a list of anime based on a search query and filters
• get_anime_details: Get details of an anime by its ID, like recommendations, studios, broadcasting, etc.
• get_anime_ranking: Get anime rankings
• get_seasonal_anime: Get seasonal anime based on year and season
• get_anime_list: Get an user's anime list based on it's username
• get_suggested_anime: [Requires Auth] Get anime recommendations for a logged user
• update_myanimelist: [Requires Auth] (Not implemented yet)
• delete_myanimelist_item: [Requires Auth] (Not implemented yet)

Manga

• get_manga: Get a list of manga based on a search query and filters
• get_manga_details: Get details of a manga by its ID
• get_manga_ranking: Get manga rankings
• get_manga_list: Get an user's manga list based on it's username
• update_mymangalist: [Requires Auth] (Not implemented yet)
• delete_mymangalist_item: [Requires Auth] (Not implemented yet)

User

• get_user_profile: [Requires Auth] (Not implemented yet)

Get an MyAnimeList API Token for Auth

To get an API token, follow these steps:

1. Go to API in profile settings.
2. Click on "Create ID".
3. Use this URL as your client's "Redirect URL":

http://localhost:8080/callback

4. Click "Submit"
5. Then click "Edit" in your generated client and you will see the the client_ID and client_secret.
6. Copy them in your .env file or environment variables (see .env_example).

Useful resources

https://myanimelist.net/apiconfig/references/authorization https://myanimelist.net/forum/?topicid=1850649&show=150#msg69272815 https://myanimelist.net/apiconfig/references/api/v2