Skip to content
MCP server

Anna's Archive and OpenAlex

Search Anna's Archive and OpenAlex for books and papers, then download or read them

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.8.2
Listing updated
2 days ago

About Anna's Archive and OpenAlex

Anna's Archive and OpenAlex is an open-source MCP server for books and literature. It runs locally on your machine and is started by your AI client.

This npm server pairs Anna's Archive with OpenAlex. Nine tools search books, textbooks, manuals and standards, search papers by title, author, topic, citation or DOI, look up editions and ISBNs in catalogues such as Open Library, WorldCat and ISBNdb, check account status, and download by file hash, book-page URL or DOI. A separate article_read tool returns passages of structured full text when an OpenAlex key is set.

Archive access needs a paid Anna's Archive membership and your secret key. The README says searching needs Lucky Librarian or higher, while the cheapest tier can download if you supply a file hash or book-page URL. OpenAlex support is optional. The server signs in with the key and renews the session itself, picks a working mirror, and the README says downloads are verified against the archive's checksum.

The author states no affiliation with Anna's Archive and asks that it be used only for material you are entitled to obtain. It also ships a command-line tool, a Go SDK, a Claude Desktop extension, Homebrew and Docker options.

Install

Run in a terminal

claude mcp add annas-mcp --env ANNAS_SECRET_KEY='<ANNAS_SECRET_KEY>' --env OPENALEX_API_KEY='<OPENALEX_API_KEY>' --env ANNAS_ACCOUNT_COOKIE='<ANNAS_ACCOUNT_COOKIE>' -- npx -y annas-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "annas-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "annas-mcp"
      ],
      "env": {
        "ANNAS_SECRET_KEY": "<ANNAS_SECRET_KEY>",
        "OPENALEX_API_KEY": "<OPENALEX_API_KEY>",
        "ANNAS_ACCOUNT_COOKIE": "<ANNAS_ACCOUNT_COOKIE>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "annas-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "annas-mcp"
      ],
      "env": {
        "ANNAS_SECRET_KEY": "<ANNAS_SECRET_KEY>",
        "OPENALEX_API_KEY": "<OPENALEX_API_KEY>",
        "ANNAS_ACCOUNT_COOKIE": "<ANNAS_ACCOUNT_COOKIE>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "annas-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "annas-mcp"
      ],
      "env": {
        "ANNAS_SECRET_KEY": "<ANNAS_SECRET_KEY>",
        "OPENALEX_API_KEY": "<OPENALEX_API_KEY>",
        "ANNAS_ACCOUNT_COOKIE": "<ANNAS_ACCOUNT_COOKIE>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "annas-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "annas-mcp"
      ],
      "env": {
        "ANNAS_SECRET_KEY": "<ANNAS_SECRET_KEY>",
        "OPENALEX_API_KEY": "<OPENALEX_API_KEY>",
        "ANNAS_ACCOUNT_COOKIE": "<ANNAS_ACCOUNT_COOKIE>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "annas-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "annas-mcp"
      ],
      "env": {
        "ANNAS_SECRET_KEY": "<ANNAS_SECRET_KEY>",
        "OPENALEX_API_KEY": "<OPENALEX_API_KEY>",
        "ANNAS_ACCOUNT_COOKIE": "<ANNAS_ACCOUNT_COOKIE>"
      }
    }
  }
}

Configuration

  • ANNAS_SECRET_KEYOptional Anna's Archive secret key for books, archive searches and archive downloads.
  • OPENALEX_API_KEYOptional OpenAlex API key for papers, dissertations, open PDFs and structured full text.
  • ANNAS_DOWNLOAD_PATHFolder for downloaded files. Defaults to annas-archive in your home folder.
  • ANNAS_ACCOUNT_COOKIEOptional aa_account_id2 cookie from a signed-in browser, for when signing in with the secret key fails.

Tools this server provides (9)

Taken from the project documentation; the running server may differ.

book_search
Finds books, textbooks, manuals and standards.
article_search
Finds papers by title, author, topic, citation or DOI.
article_details
Inspects a paper's metadata and copy details.
metadata_search
Searches library catalogs for editions and ISBNs.
book_details
Shows ISBNs, edition, description and reported file problems.
account_status
Shows membership, search access and remaining fast downloads.
book_download
Downloads a book by file hash or book-page URL.
article_download
Downloads a paper by DOI or file hash.
article_read
Reads passages of structured full text via OpenAlex.

What it does

Book and paper search
Search by title, author, topic, citation or DOI with format, language and year filters.
Catalogue lookups
Find editions and ISBNs via Open Library, WorldCat and ISBNdb.
Verified downloads
Download books and papers by hash, URL or DOI.
Full-text reading
Read structured passages through optional OpenAlex support.
CLI and Go SDK
annas-cli and a Go package share the same operations.
Many install paths
npm, Claude Desktop extension, Homebrew, Gemini CLI and Docker.

Good for

  • Find an EPUB of a known title and save it
  • Download a paper by DOI
  • Look up the ISBNs and editions of a book
  • Read passages of an open-access paper
  • Check remaining fast downloads on your membership

Pricing

Open source

Free software; requires a paid Anna's Archive membership for archive access.

Anna's Archive and OpenAlex FAQ

Do I need a membership?

Yes. Archive access needs a paid Anna's Archive membership; search needs Lucky Librarian or higher.

Is OpenAlex required?

No, an OpenAlex API key is optional and unlocks papers, open PDFs and structured full text.

Can I run it outside an AI client?

Yes, annas-cli offers the same operations in a terminal.

Is it affiliated with Anna's Archive?

No, the author says it is not.

Is Anna's Archive and OpenAlex free?

Yes. Anna's Archive and OpenAlex is open source, so you can use and self-host it for free.

How do I add Anna's Archive and OpenAlex to Claude Code?

Run this command in your terminal: claude mcp add annas-mcp --env ANNAS_SECRET_KEY='<ANNAS_SECRET_KEY>' --env OPENALEX_API_KEY='<OPENALEX_API_KEY>' --env ANNAS_ACCOUNT_COOKIE='<ANNAS_ACCOUNT_COOKIE>' -- npx -y annas-mcp

What are the best alternatives to Anna's Archive and OpenAlex?

The closest alternatives to Anna's Archive and OpenAlex are ASTra, 一孔录《论语》 Yikonglu Analects, List Of Books, CARTESIAN ECU and Invoices.

Alternatives to Anna's Archive and OpenAlex

  1. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  2. List Of Books

    MCP server

    Book series reading orders, author series and book-to-series lookups via MCP and REST

    • 5 tools
    • Remote
    • Freemium
    • Books and literature
  3. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents
  4. Invoices

    MCP server

    MCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files

    • 4 tools
    • Remote
    • Paid
    • Files and documents
  5. SigPen

    MCP server

    MCP server that drafts e-signature documents while you approve every send

    Not checked yet
    • 13 tools
    • Remote
    • Freemium
    • Files and documents