mac_messages_mcp

mac_messages_mcp

93

Mac Messages MCP is a Python tool that allows interaction with macOS Messages via Multiple Context Protocol, enabling features like reading, filtering, and sending iMessages through an API. It requires macOS and full disk access permissions due to its direct database interactions.

Mac Messages MCP

A Python bridge for interacting with the macOS Messages app using MCP (Multiple Context Protocol).

Features

  • Read recent messages from the macOS Messages app
  • Filter messages by contact
  • Send new messages through iMessage
  • Access messages via an API

Prerequisites

  • macOS (tested on macOS 11+)
  • Python 3.10+
  • uv package manager

Installation

This application requires Full Disk Access permission for your terminal or application to access the Messages database.

Integration

Integrate with Claude Desktop or Cursor by adding specific configurations to access MCP servers.

Usage

  • As a module to get recent messages or send messages.
  • As a command-line tool to run the MCP server directly.

Security Notes

The application accesses the Messages database directly, which contains personal communications. Use it responsibly and ensure you have appropriate permissions.