Full-text search across all indexed PDF documents. Returns matching documents with snippets and match counts.

Get the full OCR text content of a document. Returns text organized by page.

Get metadata for a document: file name, path, page count, file size, processing state, and folder reference.

List all indexed document folders with their IDs and paths.

List documents in a specific folder with processing state. Supports pagination.

Get OCR processing statistics: total documents, counts by state (completed, not_processed, processing, error, etc.), per-folder breakdown.

Get a PNG thumbnail of a specific document page. Returns base64-encoded image data.

Export OCR text and metadata for multiple documents at once. Useful for bulk text extraction.

Get application health status, version, uptime, and active port.

Get current UI state: selected document, list item count, search/browse mode, focused field.

Get the currently animated OCR hit rects on the document preview. Returns the active search text, per-rect page index, matched text, and the four corner points in normalized page coordinates [0.0..1.0] (origin top-left). Use this to debug highlights drawn outside the page bounds.

Trigger a search in the app UI. Sets the search text and initiates the search, returning the result count.

Navigate in the document list: move up/down, jump to first/last, or go to a specific index.

Select a specific document by ID or index in the current list.

Take a screenshot of the main application window. Returns base64-encoded PNG image.

Reveal a document in macOS Finder by document_id or file_path. Only works when the app runs on the same Mac as the MCP client.

Open a document (by document_id or file_path) with the default macOS application, e.g. Preview for PDFs. Only works when the app runs on the same Mac as the MCP client.

Re-queue a document for OCR processing. Useful when OCR failed or the document was updated.

Rescan a folder (by folder_id) for new or changed files. Initiates an asynchronous folder scan.

Get current license status: state (active/trial/grace/inactive/blocked), entitlement kind, expiration, days left, provider source, last sync date, and any issues.

Refresh license status by re-syncing with the license server. Use force=true to bypass cache.

Get current app settings. Specify a category or omit for all settings.

Read header and mailbox metadata for an Apple Mail message by RFC message-id. Requires Apple Mail indexing to be enabled.

Open Apple Mail and jump to the message with the given RFC message-id. Only works when MCP client and app run on the same Mac.

Returns Apple Mail indexer status: enabled flag, is_indexing, indexed_count, last_seen_rowid, envelope_index_path/readable, MailFtsSqlite db path.

Returns the most recently indexed mails from MailFtsSqlite with subject/sender/date/snippet preview.

Returns mailbox-rowid + URL pairs from the Apple Mail Envelope Index for account-filter setup.

Configure Apple Mail indexing programmatically: bookmark mail_root (default ~/Library/Mail), optionally clear the index, set OCR size limit and account filter, then enable. Avoids the onboarding sheet entirely.

Disable Apple Mail indexing and remove the sidebar item. Index is kept on disk.

Wipe MailFtsSqlite rows and reset the indexer cursor to 0. Next index run will re-read from scratch.

Trigger an indexer run. Pass restart=true to stop the current task first.

Counters across all mailFtsMeta rows: success, empty, failed, pending. Use to verify completeness of Apple Mail index.

List Apple Mail records that are not 'success' (empty/failed/pending) with externalId, attemptCount, errorReason, envelopeRowid.

Reset attemptCount and indexStatus='pending' for all non-success records and trigger an indexer run. Pulls newly-arrived .emlx bodies in.

GC stale records: 'empty' with attemptCount>=10 older than 30 days, 'failed' older than 90 days.

List Office-attachment Cloud-Jobs (mailCloudJobs). Returns per-job docPortJobId, status, attemptCount, attachment metadata. Use status filter for slice.

Reset all 'failed' Office-attachment Cloud-Jobs to 'pending' with attemptCount=0, then trigger an immediate worker-tick.

Cancel all 'pending' Office-attachment Cloud-Jobs (set status='notSupported', reason='user cancelled').

Trigger an immediate MailCloudWorker tick (process downloaded/pending/polling jobs now instead of waiting for the 30-second timer).

Full detail of an indexed mail by external-id (RFC message-id): header fields, mailbox, attachment list and indexed body/attachment text.

Peek at an indexed mail by its MailFtsSqlite rowid. Returns subject/sender/date/snippet for that single row.

Reveal the .emlx file of an indexed mail in Finder (falls back to opening it in Apple Mail). Only works on the same Mac as the app.

List attachments of an indexed mail: external files from the Apple Mail Attachments folder plus inline MIME parts. Returns name, size, content_type and kind (external/inline).

Fetch a single attachment of an indexed mail by name. Returns base64 by default; for large attachments pass save_to_path to write the file to disk instead of returning base64.

Get OCR bounding boxes for a document: per-rect page index, recognised text and x/y/width/height in normalized page coordinates. Optionally filter by page.

Get aggregate stats for a folder: total documents, total pages and a breakdown by processing state.

Get the OCR processing status of a folder: whether it is currently processing plus counts for processing/pending/completed/failed.

Get the live OCR processing progress: is_processing flag, total/processed item counts and progress percent.

List recently scanned items with file name/path/type, creation date and read state.

Get the number of recently scanned items not yet marked as read.

Mark a recent scan item as read by its scan ID.

Add a folder to the indexed search folders by absolute path. The path must exist and be a directory.

Remove a folder (by folder_id) from the index. Destructive. Requires confirm=true.

Delete a single document (by document_id) from the index. Destructive. Requires confirm=true.

Delete multiple documents (document_ids) from the index at once. Destructive. Requires confirm=true.

Update search settings. Accepted fields: case_sensitive, fuzzy_search, whole_word, max_results, search_in_filenames, highlight_matches, auto_search, snippet_length, exclude_patterns, min_query_length.

Update OCR/processing settings. Accepted fields: ocr_enabled, ocr_language, auto_process_new, max_concurrent_tasks, process_images, process_pdfs, thumbnail_quality, ocr_quality, max_file_size_mb.

Update appearance settings. Accepted fields: theme, accent_color, sidebar_visible, list_density, show_thumbnails, font_size, grid_view.

Update mobile-sharing settings. Accepted fields: enabled, require_approval, share_name, max_devices, auto_accept_known, read_only, sharee_key.

List the items currently shown in the app's document list.

Get the document preview zoom state: zoom_level, min/max zoom and fit_mode.

Set the document preview zoom. Pass zoom_level (a value between min and max) and/or fit_mode.

Get the current page state of the document preview: current_page and total_pages.

Navigate the document preview. Pass action (first/prev/next/last) or page (1-based page number).

Get the transcript panel state: visible flag and mode.

Set the transcript panel. Pass visible (bool) and/or mode (e.g. split / searchResults).

Get the current list sort order plus the list of available sort orders.

Set the list sort order. Pass sort with one of the values returned by ui_get_sort (e.g. relevance / new2Old / old2New / a2z / z2a).

Get the active list filters: file_types, date_range and folders.

Set list filters. Pass file_types (array), date_range (string) and/or clear=true to reset all filters first.

List the popups/sheets currently presented in the app UI.

Dismiss a presented popup/sheet in the app UI.

List the NSAlerts currently shown by the app: title, message, window and button titles.

Dismiss active app alerts. Pass button_title or button_index to click a specific button, or dismiss_all=true to close every open alert.

Activate a license using license_key. Sensitive. Requires confirm=true.

Deactivate the current license. Sensitive. Requires confirm=true.

Start a trial period. Sensitive. Requires confirm=true.

Get cloud-service status: enabled flag, conditions_accepted, number of scanned folders and item counts by state.

List cloud-service items across all folders with file path, folder, state and modification date. Optionally filter by state.

Control the cloud service. Pass enabled to toggle it (requires accept_conditions=true once), or omit to run a cleanup of completed items.

Get mobile-sync status: number of connected folders, HTTP folders and polling state.

List folders shared with mobile devices including backend, client identifier and last sync timestamps.

Trigger a mobile sync. Pass folder_path to sync a single connected folder, or omit to sync all.

Confirm a mobile-device pairing using the 9-digit code. Sensitive. Requires confirm=true.