AniList MCP server for accessing AniList API data
A Model Context Protocol (MCP) server that interfaces with the AniList API, allowing LLM clients to access and interact with anime, manga, character, staff, and user data from AniList.
Clone the repository and install dependencies:
git clone https://github.com/yuna0x0/anilist-mcp.git
cd anilist-mcp
bun install # or use npm, yarn, pnpm
To get an API token, follow these steps:
https://anilist.co/api/v2/oauth/pin
{clientID} with the client ID you get. It will ask you to log in and then provide you with the token to use..env file or environment variables.Create a .env file by copying the example:
cp .env.example .env
Edit the .env file and add your AniList API token:
ANILIST_TOKEN=your_api_token
You can also provide the API token directly when running the server:
ANILIST_TOKEN=your_api_token bun start
bun start # or use npm, yarn, pnpm
ANILIST_TOKEN=your_api_token bunx anilist-mcp
You can use the MCP Inspector to test and debug the AniList MCP server:
# Using the package.json script
bun run inspector # or use npm, yarn, pnpm
# Alternative: Direct use with bunx (or npx)
bunx @modelcontextprotocol/inspector -e ANILIST_TOKEN=your_api_token bunx anilist-mcp
Then open your browser to the provided URL (usually http://localhost:5173) to access the MCP Inspector interface. From there, you can:
This is particularly useful for testing your setup before connecting it to Claude or another AI assistant.
claude_desktop_config.json:{
"mcpServers": {
"anilist": {
"command": "npx",
"args": ["-y", "anilist-mcp"],
"env": {
"ANILIST_TOKEN": "your_api_token"
}
}
}
}
get_genres - Get all available genres on AniListget_media_tags - Get all available media tags on AniListget_site_statistics - Get AniList site statistics over the last seven daysget_studio - Get information about a studio by its AniList ID or namefavourite_studio - [Requires Login] Favourite or unfavourite a studio by its IDdelete_activity - [Requires Login] Delete the current authorized user's activity postget_activity - Get a specific AniList activity by its IDget_user_activity - Fetch activities from a userpost_message_activity - [Requires Login] Post a new message activity or update an existing onepost_text_activity - [Requires Login] Post a new text activity or update an existing oneget_user_anime_list - Get a user's anime listget_user_manga_list - Get a user's manga listadd_list_entry - [Requires Login] Add an entry to the authorized user's listremove_list_entry - [Requires Login] Remove an entry from the authorized user's listupdate_list_entry - [Requires Login] Update an entry on the authorized user's listget_anime - Get detailed information about an anime by its AniList IDget_manga - Get detailed information about a manga by its AniList IDfavourite_anime - [Requires Login] Favourite or unfavourite an anime by its IDfavourite_manga - [Requires Login] Favourite or unfavourite a manga by its IDget_character - Get information about a character by their AniList IDget_staff - Get information about staff member by their AniList IDfavourite_character - [Requires Login] Favourite or unfavourite a character by its IDfavourite_staff - [Requires Login] Favourite or unfavourite a staff member by their IDget_todays_birthday_characters - Get all characters whose birthday is todayget_todays_birthday_staff - Get all staff members whose birthday is todayget_recommendation - Get an AniList recommendation by its IDget_recommendations_for_media - Get AniList recommendations for a specific mediasearch_activity - Search for activities on AniListsearch_anime - Search for anime with query term and filterssearch_manga - Search for manga with query term and filterssearch_character - Search for characters based on a query termsearch_staff - Search for staff members based on a query termsearch_studio - Search for studios based on a query termsearch_user - Search for users on AniListget_thread - Get a specific thread by its AniList IDget_thread_comments - Get comments for a specific threaddelete_thread - [Requires Login] Delete a thread by its IDget_user_profile - Get a user's AniList profileget_user_stats - Get a user's AniList statisticsget_full_user_info - Get a user's complete profile and stats informationget_user_recent_activity - Get recent activity from a userget_authorized_user - [Requires Login] Get profile information of the currently authorized userfollow_user - [Requires Login] Follow or unfollow a user by their IDupdate_user - [Requires Login] Update user settingsCan you search for anime similar to "Bocchi the Rock!"?
Can you tell me about the character Hitori Gotou? Use the AniList tools to find information.
What anime has Studio Ghibli produced? Can you list their most popular works?
MIT License