A bridge for interacting with macOS Messages app through MCP
Project description
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
Requirements
- macOS (tested on macOS 11+)
- Python 3.10+
- Access to the Messages app and its database
Installation
# Clone the repository
git clone https://github.com/carterlasalle/mac-messages-mcp.git
cd mac-messages-mcp
# Install dependencies
pip install -e .
Usage
As a Module
from mac_messages_mcp import get_recent_messages, send_message
# Get recent messages
messages = get_recent_messages(hours=48)
print(messages)
# Send a message
result = send_message(recipient="+1234567890", message="Hello from Mac Messages MCP!")
print(result)
As a Command-Line Tool
# Run the MCP server
mac-messages-mcp
Development
Versioning
This project uses semantic versioning. See VERSIONING.md for details on how the versioning system works and how to release new versions.
To bump the version:
python scripts/bump_version.py [patch|minor|major]
Security Notes
This application accesses the Messages database directly, which contains personal communications. Please use it responsibly and ensure you have appropriate permissions.
License
MIT
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mac_messages_mcp-0.4.0.tar.gz.
File metadata
- Download URL: mac_messages_mcp-0.4.0.tar.gz
- Upload date:
- Size: 14.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.6.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
45e1694518f81ffbbc03b20ba509934a91bc446a457e3e249bf0a6039d8f97e6
|
|
| MD5 |
b2b9dc631a565dab023aaafc9a6cdeb0
|
|
| BLAKE2b-256 |
82c29150e7505d6a8ae35221e1064592e974e085000e90a29e8f14b21c2330e3
|
File details
Details for the file mac_messages_mcp-0.4.0-py3-none-any.whl.
File metadata
- Download URL: mac_messages_mcp-0.4.0-py3-none-any.whl
- Upload date:
- Size: 13.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.6.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
060a3cc77f50033b7e66cc24564900c4e6f54d3f9f00ff1df7ce77647857c4cb
|
|
| MD5 |
86aa10a07e95d7fc7ec2d4317f4f15eb
|
|
| BLAKE2b-256 |
8e16a6bec5f47a5887819dd06e75fe54f650bbfc31594d137a4d90ed43d7b98d
|
