Support Center

Get help with AgentMail Companion

Whether you're pairing a new device, configuring tunnels, or triaging automation workflows, this page centralizes the official support channels, troubleshooting guides, and prerequisites required by Apple's review guidelines.

Review our privacy policy Download on the App Store

Documentation

Step-by-step setup guides and host automation checklists live in the public docs.

Open docs

Email Support

Report bugs, request features, or ask questions directly via email. Include diagnostic logs for faster resolution.

Email app_support@mcpagentmail.com

Community Discussion

Join discussions about AI agent coordination and share your automation workflows.

Visit GitHub Discussions

Common issues

Cannot connect to host

•Confirm the MCP Agent Mail server is running on your dev host (uv run scripts/run_server_with_token.sh).
•Check Cloudflare Tunnel, Tailscale/Headscale, or LAN connectivity based on your selected transport.
•Ensure your iOS device is on a network that can reach the host and that the pairing token has not expired.

Push notifications are missing

•Verify notifications are enabled under iOS Settings → AgentMail Companion.
•Double-check APNs credentials on your host and confirm outbound access to Apple’s push gateways.
•Open the AgentMail Companion app to resync if the device has been offline for a long period.

App freezes or crashes

•Force-quit the app, then relaunch to clear any stale SwiftData cache state.
•Confirm you are on the latest TestFlight/App Store build.
•If the issue persists, attach `/Logs/AgentMailCompanion*.log` when filing a GitHub issue.

Minimum requirements

▹iOS 17.0+ on iPhone or iPad
▹Development host running MCP Agent Mail on Linux or macOS
▹uv, git, python3.11+, and tmux installed on the host
▹Connectivity via Cloudflare Tunnel, Tailscale/Headscale, or local LAN

Response expectations

✅ Email support: acknowledgement within 24 hours.
✅ Community discussions: monitored daily for new questions and feature requests.
✅ Critical outages: prioritized immediately via email.
ℹ️ Include app version, iOS build, and host logs for faster resolution.

Version 0.1.0 • Last updated November 12, 2025

AgentMail Companion keeps all source code and automation data on infrastructure you control. This support page satisfies the App Store's requirement for a publicly accessible help resource and a direct contact method.