sameelarif/imessage-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

10 stars 3 forks 品質 76 トレンド 18MIT

Repository Install

Access your iMessage conversations through the Model Context Protocol

概要

Access your iMessage conversations through the Model Context Protocol Read, search, and send iMessages directly from Claude, Cursor, or any MCP-compatible client. No external servers required — works locally with your iMessage database. ⚠️ — This MCP server reads directly from local macOS database files (~/Library/Messages/chat.db and ~/Library/Application Support/AddressBook/). It must run on the same Mac where your iMessages are loaded and Apple ID is configured. Remote or cloud deployment is not supported.

README

以下は原文 README の抜粋です。原文を見る。

💬 iMessage MCP Server

Access your iMessage conversations through the Model Context Protocol

Read, search, and send iMessages directly from Claude, Cursor, or any MCP-compatible client. No external servers required — works locally with your iMessage database.

⚠️ Local-only server — This MCP server reads directly from local macOS database files (~/Library/Messages/chat.db and ~/Library/Application Support/AddressBook/). It must run on the same Mac where your iMessages are loaded and Apple ID is configured. Remote or cloud deployment is not supported.

✨ Features

🚀 Quick Start

Prerequisites

macOS with iMessage configured
Node.js 18 or later
Full Disk Access permission (see below)

Installation

git clone https://github.com/sameelarif/imessage-mcp.git
cd imessage-mcp
pnpm install
pnpm build

Granting Full Disk Access

The MCP server needs permission to read your iMessage database.

Open System Settings → Privacy & Security → Full Disk Access
Click the + button
Add your terminal app (Terminal, Claude Desktop, Cursor, Warp, VS Code, Ghostyy, etc.)
Restart the application

🔧 Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "imessage": {
      "command": "node",
      "args": ["/absolute/path/to/imessage-mcp/dist/index.js"]
    }
  }
}

Environment Variables

Variable	Description	Default
`LOG_LEVEL`	Logging verbosity (`debug`, `info`, `warn`, `error`)	`info`
`DEBUG`	Enable SDK debug mode	`false`

🛠️ Available Tools

Tool	Description

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "imessage": {
      "command": "node",
      "args": ["/absolute/path/to/imessage-mcp/dist/index.js"]
    }
  }
}