# Anna's Archive and OpenAlex

> Anna's Archive and OpenAlex is an open-source MCP server for books and literature. Search Anna's Archive and OpenAlex for books and papers, then download or read them. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows, self-hosted
- **Repository:** https://github.com/sokolskynikita/annas-mcp
- **MCP Registry name:** io.github.SokolskyNikita/annas-mcp
- **Categories:** books and literature, files and documents
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [一孔录《论语》 Yikonglu Analects](https://ai-powered.com/mcp/yikonglu-analects): 一孔录《论语》 Yikonglu Analects is a free MCP server for books and literature.
- [List Of Books](https://ai-powered.com/mcp/list-of-books): List Of Books is a freemium MCP server for books and literature.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/anna-s-archive-and-openalex
