Mac MCP logo

Mac MCP

Unclaimed

by DaniAkash

Read-only MCP server for native macOS apps (Mail, Notes, Calendar, Reminders, Contacts, Messages, Spotlight).

Install

$bunx -y github:DaniAkash/mac-mcp

Set up this server

This server needs project-specific setup. Follow the project instructions; no reusable public launch command is available yet.

Project instructions

More in Productivity

Browse the full directory

Unclaimed listing

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

20 of 20 tools

Documented tools (20)

From project documentation. A server handshake does not verify each tool’s description or behavior.

calendar_get_event

Full event by UUID with description and last-modified.

calendar_list_calendars

List every calendar with id, title, type (Local, CalDAV, Birthdays, Subscribed, etc.) and color.

calendar_list_events

Events sorted by start time. Optional calendar id and YYYY-MM-DD date bounds.

calendar_search

Substring search across title, description, and location with optional date bounds.

contacts_get

Fetch a full record by Apple's ZUNIQUEID (<GUID>:ABPerson). Includes every email, phone, postal address, URL, and the note text.

contacts_list

Page through contacts merged across every AddressBook source; output is sorted by display name.

contacts_search

Substring search by name (first/last/nick/organisation), email (normalised), phone (digits or last-four), or all.

mail_get_email

Fetch a full email by Mail.app integer id with body, recipients, headers. Pass includeHtml: true to also return the raw text/html MIME part on the response (capped at 1 MiB).

mail_get_email_attachment

Fetch one attachment's bytes as base64 by 0-based index. Default cap 5 MiB, hard cap 10 MiB; larger attachments return an error envelope describing the actual size.

mail_get_email_attachments

List attachment metadata for an email: index, filename, content type, size, disposition, optional content-id.

mail_get_email_links

Extract every URL from an email body and the List-Unsubscribe / List-Help / List-Archive headers. Returns (url, kind, text?, inHeader?) records. Optional kinds filter, dedupe, and limit.

mail_get_emails

Recency-sorted email list. Optional account, mailbox, category (primary/transactions/updates/promotions), filter (all/unread/flagged/today/last7days), before/after (YYYY-MM-DD), and groupby to bucket by unread state, category, or account.

mail_list_accounts

List all Mail accounts with display names + UUIDs.

mail_list_mailboxes

List mailboxes per account with current unread counts.

mail_resolve_addresses

Bulk-resolve 1 to 100 bare email addresses against the local AddressBook. Returns a contact summary per email on exact match, null otherwise. Substring matches are filtered out.

mail_search

FTS5 BM25 search across subject/sender/body with scope, account, mailbox, category, and date filters.

reminders_get_reminder

Full reminder by identifier with notes, start/due/completion dates.

reminders_list_lists

Every list across every account; type distinguishes regular lists from Smart Lists.

reminders_list_reminders

Reminders sorted by due date. Optional list id and open/completed/all status (default open).

reminders_search

Substring search across title and notes.

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about Mac MCP Server

How do I connect Mac MCP Server to Claude?
The listing records `bunx -y github:DaniAkash/mac-mcp` as its setup step. Run it, then follow the repository's instructions for the client configuration; the listing names Claude Code, Cursor and Claude Desktop as compatible clients.
Is Mac MCP Server free?
The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can Mac MCP Server do?
Mac MCP Server documents 20 tools to the agent, including calendar_get_event, calendar_list_calendars, calendar_list_events. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.