{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_wk38cu27dyfy","handle":"iflow-mcp-hannesrudolph-imessage-query-fastmcp-m","url":"https://wellknown.network/agents/iflow-mcp-hannesrudolph-imessage-query-fastmcp-m","links":{"self":"https://wellknown.network/agents/iflow-mcp-hannesrudolph-imessage-query-fastmcp-m/record.json","html":"https://wellknown.network/agents/iflow-mcp-hannesrudolph-imessage-query-fastmcp-m","markdown":"https://wellknown.network/agents/iflow-mcp-hannesrudolph-imessage-query-fastmcp-m/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-hannesrudolph-imessage-query-fastmcp-m","status":"https://wellknown.network/api/v1/agents/iflow-mcp-hannesrudolph-imessage-query-fastmcp-m/status","claim":"https://wellknown.network/agents/iflow-mcp-hannesrudolph-imessage-query-fastmcp-m/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-hannesrudolph-imessage-query-fastmcp-m/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-hannesrudolph-imessage-query-fastmcp-m/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-hannesrudolph-imessage-query-fastmcp-m/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-hannesrudolph-imessage-query-fastmcp-m/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-hannesrudolph-imessage-query-fastmcp-m","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_hannesrudolph-imessage-query-fastmcp-mcp-server","summary":"An MCP server that provides safe access to your iMessage database through Model Context Protocol (MCP).","description":"# iMessage Query MCP Server\n\nAn 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.\n\n## 📋 System Requirements\n\n- macOS (required for iMessage database access)\n- Python 3.6+\n\n## 📦 Dependencies\n\nInstall all required dependencies:\n\n```bash\n# Using pip\npip install -r requirements.txt\n```\n\n### Required Packages\n- **fastmcp**: Framework for building Model Context Protocol servers\n- **imessagedb**: Python library for accessing and querying the macOS Messages database\n- **phonenumbers**: Google's phone number handling library for proper number validation and formatting\n\nAll dependencies are specified in `requirements.txt` for easy installation.\n\n## 📑 Table of Contents\n- [System Requirements](#-system-requirements)\n- [Dependencies](#-dependencies)\n- [MCP Tools](#%EF%B8%8F-mcp-tools)\n- [Getting Started](#-getting-started)\n- [Installation Options](#-installation-options)\n  - [Claude Desktop](#option-1-install-for-claude-desktop)\n  - [Cline VSCode Plugin](#option-2-install-for-cline-vscode-plugin)\n- [Safety Features](#-safety-features)\n- [Development Documentation](#-development-documentation)\n- [Environment Variables](#%EF%B8%8F-environment-variables)\n\n## 🛠️ MCP Tools\n\nThe server exposes the following tools to LLMs:\n\n### get_chat_transcript\nRetrieve message history for a specific phone number with optional date filtering. Includes:\n- Message text and timestamps\n- Attachment information (if any)\n- Proper phone number validation\n- Date range filtering\n\n## 🚀 Getting Started\n\nClone the repository:\n\n```bash\ngit clone https://github.com/hannesrudolph/imessage-query-fastmcp-mcp-server.git\ncd imessage-query-fastmcp-mcp-server\n```\n\n## 📦 Installation Options\n\nYou can install this MCP server in either Claude Desktop or the Cline VSCode plugi…","publisher":null,"homepage":null,"repository":null,"version":"0.1.1","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_hannesrudolph-imessage-query-fastmcp-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.859,"provenance":"derived"}],"categories":["data","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"iflow-mcp_hannesrudolph-imessage-query-fastmcp-mcp-server","registry":"pypi","observedAt":"2026-09-15T18:21:49.661Z","publishedAt":"2026-02-08T04:36:11.394068Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_hannesrudolph-imessage-query-fastmcp-mcp-server","url":"https://pypi.org/project/iflow-mcp_hannesrudolph-imessage-query-fastmcp-mcp-server/","firstSeenAt":"2026-09-09T19:23:27.728Z","fetchedAt":"2026-09-15T18:19:57.393Z","normalizedAt":"2026-09-15T18:19:57.393Z"}]},"firstSeenAt":"2026-09-09T19:23:27.728Z","updatedAt":"2026-09-15T18:21:49.661Z"}