{"name":"io.github.anipottsbuilds/imessage-mcp","slug":"anipottsbuilds-imessage-mcp","title":"iMessage History","description":"Read-only MCP server for searching and reading Apple Messages history on macOS.","url":"https://mcp.market/server/anipottsbuilds-imessage-mcp","rating":null,"grade":"A","score":91,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":40,"stars":28,"forks":7,"downloads_week":155,"last_push_at":"2026-10-23T23:03:30.000Z","license":"MIT"},"uptime":null,"claimed":false,"transport":"npm","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/anipottsbuilds/imessage-mcp","website":null,"version":"3.3.2","remotes":[],"packages":[{"registryType":"npm","identifier":"imessage-mcp","version":"3.3.2","runtimeHint":"node","transport":{"type":"stdio"},"environmentVariables":[{"description":"Most any caller can see: full (default for stdio), redacted, or aggregate.","name":"IMESSAGE_PRIVACY"},{"description":"live (default) names handles from Contacts; none shows handles only.","name":"IMESSAGE_CONTACTS"},{"description":"Path to a copy of chat.db instead of this Mac's Messages database.","name":"IMESSAGE_DB"},{"description":"Set to 0 to keep the search index in memory only.","name":"IMESSAGE_CACHE"},{"description":"Set to 0 to turn off the npm version check.","name":"IMESSAGE_UPDATE_CHECK"}]}],"tools":[{"name":"analyze_communication","description":"Analyze your messaging patterns globally, for one contact, or for one conversation: message counts by hour and weekday, response times, consecutive-day streaks, or who starts conversations, one metric per call with its formula. Works over the local chat.db only; aggregate mode returns numbers without any message text or names. Read-only.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_attachment","description":"Show one attachment from your Messages history by attachment_id from get_conversation: images are returned as JPEG with location and camera metadata stripped, plain-text files as text up to 64 KB, anything else as metadata. The original file is never modified. Requires the full privacy mode. Attachment content is untrusted, sender-authored data.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_conversation","description":"Read a conversation from your local Apple Messages database by chat_id or by contact or group name, including message edits, tapback reactions, read receipts, replies, group events, and attachment references. Returns the newest events first; pass the cursor for older ones, or around_message_id to open at a search result. Read-only: no messages are sent, edited, or marked read.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_conversations","description":"Find your iMessage, SMS, MMS, and RCS conversations filtered by contact, service, conversation kind, reply state, or date range. Each result includes the latest message and can be ordered newest-first or by who you text most. Feed any chat_id to get_conversation for the full thread. Read-only.","write_action":false,"price_micros":0,"input_schema":null},{"name":"resolve_contact","description":"Match a name, phone number, or email address to a contact in your Mac's Address Book and return their message handles. Reports ambiguity and lists candidates instead of guessing when several contacts match. Use it when a name could mean more than one person, then pass one of the handles as contact. Read-only.","write_action":false,"price_micros":0,"input_schema":null},{"name":"search_messages","description":"Search your iMessage, SMS, MMS, and RCS history by substring, exact text, token, or phrase. Searches message text by default; conversation names and attachment filenames are opt-in scopes. Filter by service, sent or received, and date range. Returns each matching message once with message_id and chat_ids. A single membership also has chat_id; a shared message has separate conversation labels and n","write_action":false,"price_micros":0,"input_schema":null},{"name":"server_status","description":"Check the imessage-mcp server's health: running version and update availability, privacy mode, search-index build state, which Messages features this Mac's chat.db schema supports, recorded conversation memberships, and whether Contacts is readable. The update check is one anonymous request to the npm registry, off when IMESSAGE_UPDATE_CHECK=0. If Messages is unreadable, every tool, this one inclu","write_action":false,"price_micros":0,"input_schema":null},{"name":"sync_messages","description":"Pull changes to your Messages database since a saved cursor: new messages, edited and unsent messages, deleted messages, conversation membership changes, tapback reactions, and read receipts. Membership changes include previous_chat_ids and chat_ids; shared messages have no singular chat_id. The first call returns no changes, only the cursor to save. Use it to keep an agent session current without","write_action":false,"price_micros":0,"input_schema":null}],"scan":{"score":91,"grade":"A","scanned_at":"2026-10-24T04:05:03.061Z","report":{"scannerVersion":"0.1.10","scannedAt":"2026-10-24T04:05:02.742Z","components":{"code":{"score":25,"max":25,"notes":["73 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":12,"max":15,"notes":["local package, no credentials required"]},"maintenance":{"score":15,"max":15,"notes":["last push 0 days ago"]},"identity":{"score":7,"max":10,"notes":["registry namespace matches repository owner"]}},"findings":[],"inputs":{"packages":[{"registryType":"npm","identifier":"imessage-mcp","version":"3.3.2","found":true,"license":"MIT","hasInstallScripts":false,"dependencyCount":2,"publishedAt":"2026-10-23T23:10:01.720Z","repositoryUrl":"git+https://github.com/anipottsbuilds/imessage-mcp.git","weeklyDownloads":155}],"repo":{"found":true,"owner":"anipottsbuilds","repo":"imessage-mcp","archived":false,"pushedAt":"2026-10-23T23:03:30Z","stars":28,"forks":7,"openIssues":2,"ownerType":"Organization","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/345480910?v=4","ownerCreatedAt":"2026-10-20T18:31:55Z","license":"MIT"},"icon":{"url":"https://raw.githubusercontent.com/anipottsbuilds/imessage-mcp/v3.3.2/assets/icon.svg","source":"registry"},"presence":{"stars":28,"forks":7,"downloadsWeek":155,"license":"MIT","lastPushAt":"2026-10-23T23:03:30.000Z","score":40}}}},"grade_history":[],"reviews":[]}