Official description10 sourcesMCP servers8d ago
hannesrudolph/imessage-query-fastmcp-mcp-server
๐ ๐ ๐ - Safe access to the iMessage database to query and analyze conversations, with phone number validationโฆ
View on GitHub โDirect link ยท no redirect page
Official description๐ ๐ ๐ - Safe access to the iMessage database to query and analyze conversations, with phone number validation and attachment handling.
Config template (adjust for your client)
claude mcp add imessage-query-fastmcp-mcp-server -- npx -y imessage-query-fastmcp-mcp-server
A pasteable skeleton generated from the repository name. Check the project README for the exact package and arguments.
- Star count
- 81 โ ยท hannesrudolph/imessage-query-fastmcp-mcp-server ยท read from the GitHub search API ยท (checked 2026-10-16 20:00:20)
- Source
- collected from the punkpeye/awesome-mcp-servers list ยท type: MCP server
- Harvest history
- first seen 2026-10-09 ยท last seen 2026-10-16 ยท seen 32ร ยท listed by 10 sources
- Score
- score 1,003 ยท 81 โ ยท 10 sources ยท mcp
FAQ (answers come from our records)
How do I install it?
We did not find an install command for this repository (our install coverage is only about 4%). Check its README or releases page.
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?
repository
hannesrudolph/imessage-query-fastmcp-mcp-server๏ผfirst catalogued 2026-10-09๏ผlast seen 2026-10-16ใThere is no official certification or quality rating here โ we record sources and dates only.Third-party quality signals
iMessage Query MCP Server
ไปฅไธๆๅฝ่ช่ฏฅไปๅบ็ README๏ผ็ๆฎต๏ผ ยท ๅจ GitHub ่ฏปๅฎๆด README โ
An MCP server that provides safe access to your iMessage database through Model Context Protocol (MCP). This server is built with the FastMCP framework and the imessagedb library, enabling LLMs to query and analyze iMessage conversations with proper phone number validation and attachment handling.
๐ System Requirements
- macOS (required for iMessage database access)
- Python 3.6+
๐ฆ Dependencies
Install all required dependencies:
Required Packages
- **fastmcp**: Framework for building Model Context Protocol servers
- **imessagedb**: Python library for accessing and querying the macOS Messages database
- **phonenumbers**: Google's phone number handling library for proper number validation and formatting
All dependencies are specified in requirements.txt for easy installation.
๐ Table of Contents
- System Requirements
- Dependencies
- MCP Tools
- Getting Started
- Installation Options
- Claude Desktop
- Cline VSCode Plugin
- Safety Features
- Development Documentation
- Environment Variables
๐ ๏ธ MCP Tools
The server exposes the following tools to LLMs:
get_chat_transcript
Retrieve message history for a specific phone number with optional date filtering. Includes:
- Message text and timestamps
- Attachment information (if any)
- Proper phone number validation
- Date range filtering
๐ Getting Started
Clone the repository:
๐ฆ Installation Options
You can install this MCP server in either Claude Desktop or the Cline VSCode plugin. Choose the option that best suits your needs.
Option 1: Install for Claude Desktop
Install using FastMCP:
Option 2: Install for Cline VSCode Plugin
To use this server with the Cline VSCode plugin:
1. In VSCode, click the server icon (โฐ) in the Cline plugin sidebar
2. Click the "Edit MCP Settings" button (โ)
3. Add the following configuration to the settings file:
Replace /path/to/repo with the full path to where you cloned this repository (e.g., /Users/username/Projects/imessage-query-fastmcp-mcp-server)
๐ Safety Features
- Read-only access to the iMessage database
- Phone number validation using the phonenumbers library
- Safe attachment handling with missing file detection
- Date range validation
- Progress output suppression for clean JSON responses
๐ Development Documentation
The repository includes documentation files for development:
๐ System Requirements
- macOS (required for iMessage database access)
- Python 3.6+
๐ฆ Dependencies
Install all required dependencies:
Required Packages
- **fastmcp**: Framework for building Model Context Protocol servers
- **imessagedb**: Python library for accessing and querying the macOS Messages database
- **phonenumbers**: Google's phone number handling library for proper number validation and formatting
All dependencies are specified in requirements.txt for easy installation.
๐ Table of Contents
- System Requirements
- Dependencies
- MCP Tools
- Getting Started
- Installation Options
- Claude Desktop
- Cline VSCode Plugin
- Safety Features
- Development Documentation
- Environment Variables
๐ ๏ธ MCP Tools
The server exposes the following tools to LLMs:
get_chat_transcript
Retrieve message history for a specific phone number with optional date filtering. Includes:
- Message text and timestamps
- Attachment information (if any)
- Proper phone number validation
- Date range filtering
๐ Getting Started
Clone the repository:
๐ฆ Installation Options
You can install this MCP server in either Claude Desktop or the Cline VSCode plugin. Choose the option that best suits your needs.
Option 1: Install for Claude Desktop
Install using FastMCP:
Option 2: Install for Cline VSCode Plugin
To use this server with the Cline VSCode plugin:
1. In VSCode, click the server icon (โฐ) in the Cline plugin sidebar
2. Click the "Edit MCP Settings" button (โ)
3. Add the following configuration to the settings file:
Replace /path/to/repo with the full path to where you cloned this repository (e.g., /Users/username/Projects/imessage-query-fastmcp-mcp-server)
๐ Safety Features
- Read-only access to the iMessage database
- Phone number validation using the phonenumbers library
- Safe attachment handling with missing file detection
- Date range validation
- Progress output suppression for clean JSON responses
๐ Development Documentation
The repository includes documentation files for development:
- Source
- awesome ยท https://github.com/hannesrudolph/imessage-query-fastmcp-mcp-server
- Browse by field
- MCP servers
- Traction
- 81 โ
- added
- yesterday
More in MCP servers
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.