Skip to content
Agentmart
Submit a tool

Apple Messages

Read Messages history on macOS and send or reply through Messages.app.

Connector by JonathanRReed · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 28
Write a review

Install

Works with Claude Code, Codex, VS Code, Claude Desktop, Cursor, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install connector/jonathanrreed-apple-messages-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Read Messages history on macOS and send or reply through Messages.app.

Use cases: team-chat

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
0 read · 13 write · 0 delete
Secrets
None asked for
Install scripts
None found
Runs as
Python package

Tools by what they do 13

Read from the source code; the running server may list different tools.

Write 13 · Create, change, send or run things.

  • messages_get_conversation
  • messages_get_message
  • messages_get_prompt
  • messages_health
  • messages_list_attachments
  • messages_list_conversations
  • messages_list_prompts
  • messages_permission_guide
  • messages_recheck_permissions
  • messages_reply_in_conversation
  • messages_search_messages
  • messages_send_attachment
Show 1 more tools
  • messages_send_message

Secrets and settings it asks for

Other settings (environment variables or headers).

  • APPLE_MESSAGES_MCP_SAFETY_MODE

Network hosts it talks to 3

  • docs.astral.sh · found in code
  • github.com · found in install command, code
  • raw.githubusercontent.com · found in code

Files it touches

  • Your home directory (~)
  • Any path the agent passes to its tools

Tools (13)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • messages_get_conversationGet Conversation

    Fetch a single Apple Messages conversation with paginated messages.

  • messages_get_messageGet Message

    Fetch a single Apple Messages message by message_id.

  • messages_get_promptMessages Get Prompt

    Fallback prompt rendering tool for tool-only MCP clients.

  • messages_healthMessages Health

    Report Messages server configuration and capability status.

  • messages_list_attachmentsList Message Attachments

    List Apple Messages attachments by chat or message.

  • messages_list_conversationsList Conversations

    List recent Apple Messages conversations.

  • messages_list_promptsMessages List Prompts

    Fallback prompt discovery tool for tool-only MCP clients.

  • messages_permission_guideMessages Permission Guide

    Explain how to grant Apple Messages permissions on macOS.

  • messages_recheck_permissionsMessages Recheck Permissions

    Recheck Messages access after the user changes macOS permissions, and notify the client that Messages resources changed.

  • messages_reply_in_conversationReply In Conversation

    Reply to an Apple Messages conversation using its chat_id. Supports both one-to-one and group chats. One-to-one replies use the service of the thread's latest message (SMS/RCS threads stay SMS/RCS) unless service_name is set. Group replies always use the group's existing service; service_name is rejected for groups unless it matches.

  • messages_search_messagesSearch Messages

    Search Apple Messages text history.

  • messages_send_attachmentSend Attachment

    Send a file attachment via Apple Messages to a recipient. Optionally include a text message.

  • messages_send_messageSend Message

    Send a new message through Messages.app. Sends as iMessage unless service_name is set: SMS or RCS go through the iPhone's carrier and need Text Message Forwarding enabled for this Mac.

Signals

Stars
28
Forks
4
Open issues
0
Contributors
6
Weekly downloads
387
Last commit (this folder)
Oct 22, 2026 (7 days ago)
Last release
Oct 22, 2026 (7 days ago)
Last package publish
Oct 22, 2026 (7 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.JonathanRReed/apple-messages-mcp
Version
1.1.3
Auth
No auth
Packages
pypi apple-messages-mcpmcpb https://github.com/JonathanRReed/Apple-MCPs/releases/download/v1.1.3/apple-messages-1.1.3.mcpb
License
MIT
Repository
github.com/JonathanRReed/Apple-MCPs
Website
github.com/JonathanRReed/Apple-MCPs
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql

More from JonathanRReed

Cite this page

Apple Messages MCP server. Agent Mart. https://agentmart.dev/connectors/jonathanrreed-apple-messages-mcp (last updated 2026-10-24)