MyAnimeList MCP Server

by nicoaguerrero

2 stars
370 downloads
Not rated
GitHub

About

A Model Context Protocol server that enables LLM clients to access and interact with the MyAnimeList API, supporting anime, manga, and user data operations.

Details

Author
nicoaguerrero
GitHub stars
2
Downloads
370
Categories
Other

- Search and filter anime and manga
- Retrieve detailed anime and manga info by ID
- Access anime and manga rankings
- Get seasonal anime and user lists
- Authenticated user profile and list management

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MyAnimeList MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via Smithery or manually by adding the server configuration to your claude_desktop_config.json using uv to run main.py. Restart Claude Desktop and use the available tools to interact with MyAnimeList.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

MyAnimeList MCP Server

smithery badge

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)

Installing via Smithery

To install myanimelist-mcp-server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @nicoaguerrero/myanimelist-mcp-server --client claude

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] Update an anime from the logged user's anime list - delete_myanimelist_item: [Requires Auth] Delete an anime from the logged user's anime list

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] Update a manga from the logged user's manga list - delete_mymangalist_item: [Requires Auth] Delete a manga from the logged user's manga list

User

- get_user_profile: [Requires Auth] Get details about the logged user

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" and select app type web.
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
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.