search_annotations

MCP tool from Apple Books MCP by vgnshiyer

Search across highlights + notes + surrounding text

How to use it

search_annotations is exposed by the Apple Books MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the search_annotations tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.

Install Apple Books MCP

$uvx apple-books-mcp

FULL APPLE BOOKS MCP LISTING

Other tools in Apple Books MCP (29)

add_book_to_collection

Add a book to a collection (idempotent)

create_collection

Create a new collection

delete_collection

Delete a user-created collection (books untouched)

describe_annotation

Get full details of a single annotation

Get details of a particular book (metadata, progress, annotation count, description)

describe_collection

Get details of a collection

get_annotation_context

Text window around a highlight (the paragraph it's in), with the highlight marked «...»

get_annotations_by_date_range

Annotations within a date range (flat, with date + book per row)

get_books_by_genre

Get books by genre (substring match)

get_books_in_progress

Get books currently being read

get_chapter_content

Plain-text content of a chapter, with optional offset + maxchars slicing

get_collection_books

Get all books in a collection

get_current_reading_position

The chapter the user last left off reading (via Apple Books' auto-bookmark CFI)

get_finished_books

Get books that have been finished

get_highlights_by_color

Highlights of a particular color, grouped by book

get_library_stats

Get library summary with reading stats

get_recently_read_books

Get most recently opened books

get_unstarted_books

Get books not yet started

list_all_annotations

Browse every annotation grouped by book, newest first

List all books

list_all_collections

List all collections

list_annotations

Get all annotations for a book (id + text + chapter per row, chapter-ordered)

list_book_chapters

Table of contents for a book (chapter titles, order, nesting)

recent_annotations

Get most recent annotations (flat, with date + book per row)

remove_book_from_collection

Remove a book from a collection (idempotent)

rename_collection

Rename a user-created collection

search_books_by_title

Search for books by title

search_collections_by_title

Search for collections by title

Search user notes (shows highlight + note inline)