M
marissamarym/imessage-mcp-server
Send iMessages and manage contacts through AppleScript
View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site
Install & config
Client config (built from the install command this repo gives)
{
"mcpServers": {
"marissamarym-imessage-mcp-server": {
"command": "npx",
"args": ["@modelcontextprotocol/inspector"]
}
}
}Parsed from the README we fetched on 2026-11-04; we have not executed it.
command/args come from the install command the repository states. When it is ambiguous, the project README wins.
VS Code (.vscode/mcp.json - the key is servers)
{
"servers": {
"marissamarym-imessage-mcp-server": {
"command": "npx",
"args": ["@modelcontextprotocol/inspector"]
}
}
}Same server, but VS Code keeps it under <code>servers</code>.
Claude Code (command line)
claude mcp add --transport stdio marissamarym-imessage-mcp-server -- npx @modelcontextprotocol/inspector
Claude Code does not read a config file; add the server with this command.
Key names differ by client: Clients & CLI
- Source
- collected from the abordage/awesome-mcp list · type: MCP server
- Harvest history
- first seen 2026-11-05 · last seen 2026-11-14 · seen 10× · listed by 10 sources
- Score
- score 1,003 · 10 sources · mcp
- Install
npx @modelcontextprotocol/inspector
FAQ (answers come from our records)
How do I install it?
The repository provides this install command:
npx @modelcontextprotocol/inspector. It comes from the repository itself; we cannot guarantee it runs as-is in your client.Who is it for?
We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
first catalogued 2026-11-05；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.
# iMessage MCP Server
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
⚠️ DISCLAIMER - USE AT YOUR OWN RISK ⚠️
This software is provided as-is, without any warranties or guarantees.
An MCP server that uses AppleScript to send iMessages and manage contacts.
This server uses AppleScript to interface with macOS Messages and Contacts apps through the Model Context Protocol (MCP). It wraps AppleScript commands in a TypeScript server to allow you to:
View and search your contacts
Send iMessages to contacts or phone numbers
Get confirmation when messages are sent
## Features
### Resources
Access your contacts via contacts://all
View contact details including names, phone numbers, and email addresses
All data stays local on your machine
### Tools
searchcontacts - Find contacts by name, phone, or email
Takes a search query and returns matching contacts
Searches across names, phone numbers, and email addresses
sendmessage - Send an iMessage
Takes recipient (phone/email) and message content
Sends through your local Messages app
Returns confirmation or error details
## Installation
1. Install dependencies:
bash
npm install
2. Build the server:
bash
npm run build
3. Configure Claude Desktop to use the server:
On MacOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
json
"mcpServers": {
"imessage": {
"command": "node",
"args": ["/path/to/imessage-server/build/server.js"]
4. Restart Claude Desktop
5. Grant permissions when prompted for:
Contacts access
Messages access
## Usage
Once installed, you can talk to Claude Desktop naturally:
"Show me my contacts"
"Search for contacts named Marissa"
"Send a message to 555-0123 saying I'll be there in 10 minutes"
"Send Alice an iMessage asking if we're still on for lunch"
## Security Notes
All operations happen locally on your machine
No contact or message data is sent to external servers
The server requires macOS permissions for Contacts and Messages access
Messages are sent through your iMessage account
## Development
For development and debugging, use the MCP Inspector:
bash
npx @modelcontextprotocol/inspector node build/server.js
## Requirements
macOS (for Messages and Contacts integration)
This software is provided as-is, without any warranties or guarantees.
An MCP server that uses AppleScript to send iMessages and manage contacts.
This server uses AppleScript to interface with macOS Messages and Contacts apps through the Model Context Protocol (MCP). It wraps AppleScript commands in a TypeScript server to allow you to:
View and search your contacts
Send iMessages to contacts or phone numbers
Get confirmation when messages are sent
## Features
### Resources
Access your contacts via contacts://all
View contact details including names, phone numbers, and email addresses
All data stays local on your machine
### Tools
searchcontacts - Find contacts by name, phone, or email
Takes a search query and returns matching contacts
Searches across names, phone numbers, and email addresses
sendmessage - Send an iMessage
Takes recipient (phone/email) and message content
Sends through your local Messages app
Returns confirmation or error details
## Installation
1. Install dependencies:
bash
npm install
2. Build the server:
bash
npm run build
3. Configure Claude Desktop to use the server:
On MacOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
json
"mcpServers": {
"imessage": {
"command": "node",
"args": ["/path/to/imessage-server/build/server.js"]
4. Restart Claude Desktop
5. Grant permissions when prompted for:
Contacts access
Messages access
## Usage
Once installed, you can talk to Claude Desktop naturally:
"Show me my contacts"
"Search for contacts named Marissa"
"Send a message to 555-0123 saying I'll be there in 10 minutes"
"Send Alice an iMessage asking if we're still on for lunch"
## Security Notes
All operations happen locally on your machine
No contact or message data is sent to external servers
The server requires macOS permissions for Contacts and Messages access
Messages are sent through your iMessage account
## Development
For development and debugging, use the MCP Inspector:
bash
npx @modelcontextprotocol/inspector node build/server.js
## Requirements
macOS (for Messages and Contacts integration)
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/marissamarym-imessage-mcp-server/)
- Source
- awesome · https://github.com/marissamarym/imessage-mcp-server
- Browse by field
- MCP servers
- Listed by
- 10 independent sources
- added
- today
More like this
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.