SokolskyNikita/annas-mcp

An MCP server and command-line tool for searching Anna's Archive for books and papers and downloading the file you pick. Use annas-cli in your terminal or connect annas-mcp to Claude, Cursor, Codex and other AI clients.
**A paid Anna's Archive membership is required.**
| Anna's Archive membership | Search through the MCP | Download by file hash or book-page URL |
| --- | --- | --- |
| No paid membership | ❌ | ❌ |
| **Brilliant Bookworm** (cheapest tier) | ❌ | ✅ |
| **Lucky Librarian or higher** (recommended) | ✅ | ✅ |
**We recommend Lucky Librarian or higher so the AI can both search and download for you.** With the basic tier you'll need to manually paste each book download URL.
Disclaimer: I'm not affiliated with Anna's Archive. They were forced to introduce strict anti-scraping limits in 2026 due to massive DDoS attacks, with only paying members exempt.
**MCP setup** · **CLI setup** · **Go SDK**
It signs in with your membership's secret key and renews the session by itself, so you never copy cookies from a browser. If you're coming from iosifache/annas-mcp, switching is a one-line change.
| Tool | What it does |
| --- | --- |
| book_search | Finds books, textbooks, manuals and standards by title, author or topic, filtered by format, language, source or year; can include file activity counts |
| article_search | Finds journal articles by keyword, author or year, or looks one up by DOI; can include file activity counts |
| metadata_search | Searches library catalogs such as Open Library, WorldCat and ISBNdb for editions and ISBNs |
| book_details | Shows a result's ISBNs and other identifiers, edition, description and reported file problems |
| account_status | Shows your membership and how many fast downloads are left |
| book_download | Downloads a book using a file hash or Anna's Archive book-page URL |
| article_download | Downloads an article by DOI or hash |
Use it only for material you are entitled to obtain, under the laws and terms that apply to you.
Go SDK
Go applications can import github.com/SokolskyNikita/annas-mcp/anna for the same search, metadata, account and verified-download operations. See the SDK guide and examples for explicit configuration, errors, timeouts and concurrency. The SDK and applications share this module’s release tags. Requires Go 1.26 or newer; install with go get github.com/SokolskyNikita/annas-mcp/anna@v0.7.0.
Setup
You need Node.js 18 or newer and an active paid Anna's Archive membership. **Lucky Librarian or higher is recommended** so both search and downloads work.
Get your secret key
Copy the secret key you log in with from your Anna's Archive account page. It is also your API key (API FAQ).
MCP setup
After getting your secret key, add the server to your client:
Claude Code
On native Windows (not WSL), end the command with -- cmd /c npx -y annas-mcp.
Claude Desktop, one click
Download annas-mcp.mcpb and open it, or drag it onto Settings → Extensions. Claude Desktop asks for your secret key and lets you pick a different download folder.
Claude Desktop or Cursor, by hand
Add this to Claude Desktop's config (Settings → Developer → Edit Config) or to Cursor's ~/.cursor/mcp.json:
Codex
Add this to ~/.codex/config.toml:
Gemini CLI
Gemini CLI asks for your secret key, which it keeps in the system keychain, then for two optional settings; press Enter to skip them. Change them later with gemini extensions config annas-mcp.
Docker
Build the image straight from this repository:
Then have your client run it, mounting your download folder at /downloads:
On Linux, add "--user", "1000:1000" with your own user and group IDs before "annas-mcp", so the container can write to the folder.
Try it
Restart your client and ask something like *"Find the EPUB of Pride and Prejudice and download it."* The AI searches, picks a copy and tells you where it saved the file: annas-archive in your home folder unless you chose another.