io.github.retep-tru/maeil MCP Server

The io.github.retep-tru/maeil Model Context Protocol (MCP) server helps coordinate a calendar invitation by phone number. It can invite someone to a calendar event and then return their real email after they accept the invitation, enabling email-based follow-up.

🛠️ Key Features

Invite a recipient to a calendar event using a phone number
Retrieve the recipient’s real email after acceptance

🚀 Use Cases

Scheduling events when only a phone number is available
Capturing an accepted attendee’s email for downstream communication

⚡ Developer Benefits

Bridges phone-number-based invitations to email-based workflows
Supports event-to-contact transition after acceptance

⚠️ Limitations

Email is available only after the invitee accepts the calendar event
Phone-number input is required to invite the recipient

send_calendar_invite

Invite a person to a calendar event using only their phone number. They receive the invite as a text message; if they accept, their real email address is returned to the organizer (retrieve it with get_invite_status, or have it POSTed to your callback_url). US and Canada phone numbers only. You must attest that you have the recipient's consent to contact them about this event.

Parameters9

phone	string	required	Recipient phone number, US/Canada. Accepts +15551234567, 15551234567, 5551234567, or (555) 123-4567.
title	string	required	Event title. Shown in the text message and on the accept page.
start	string	required	Event start. ISO 8601 datetime (e.g. 2026-06-15T14:00:00Z) or a date (2026-06-15) for an all-day event.
end	string	optional	Optional event end, same formats as start.
location	string	optional	Optional location (e.g. "Phone", an address, or a meeting link).
description	string	optional	Optional event description / notes.
organizer	string	required	Organizer email. The RSVP and the recipient's revealed email are delivered to this address.
consent_attestation	string	required	REQUIRED. A short statement of the basis on which you are permitted to text this person about this event (e.g. "client booked by phone on 6/1", "met at conference and exchanged numbers"). This is the legal basis for the message; sends without it are refused.
callback_url	string	optional	Optional public https URL. maeil POSTs the recipient's response (and email) here when they accept or decline.

Raw schema

{
  "type": "object",
  "properties": {
    "phone": {
      "type": "string",
      "description": "Recipient phone number, US/Canada. Accepts +15551234567, 15551234567, 5551234567, or (555) 123-4567."
    },
    "title": {
      "type": "string",
      "description": "Event title. Shown in the text message and on the accept page."
    },
    "start": {
      "type": "string",
      "description": "Event start. ISO 8601 datetime (e.g. 2026-06-15T14:00:00Z) or a date (2026-06-15) for an all-day event."
    },
    "end": {
      "type": "string",
      "description": "Optional event end, same formats as start."
    },
    "location": {
      "type": "string",
      "description": "Optional location (e.g. \"Phone\", an address, or a meeting link)."
    },
    "description": {
      "type": "string",
      "description": "Optional event description / notes."
    },
    "organizer": {
      "type": "string",
      "description": "Organizer email. The RSVP and the recipient's revealed email are delivered to this address.",
      "format": "email"
    },
    "consent_attestation": {
      "type": "string",
      "description": "REQUIRED. A short statement of the basis on which you are permitted to text this person about this event (e.g. \"client booked by phone on 6/1\", \"met at conference and exchanged numbers\"). This is the legal basis for the message; sends without it are refused."
    },
    "callback_url": {
      "type": "string",
      "description": "Optional public https URL. maeil POSTs the recipient's response (and email) here when they accept or decline.",
      "format": "uri"
    }
  },
  "required": [
    "phone",
    "title",
    "start",
    "organizer",
    "consent_attestation"
  ],
  "additionalProperties": false
}

Maeil

io.github.retep-tru/maeil MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

send_calendar_invite

get_invite_status

Install

Remote endpoint