MCP server overview


Endpoint	`https://mcp.langmail.me/mcp`
Transport	Streamable HTTP
Authorization	OAuth 2.1 bearer token — see How authorization works
Server name	`langmail-mcp`
Surface	10 tools; no MCP resources or prompts

The server is stateless: every request is authenticated independently, and all tools operate on the mailbox of the user who granted the token.

Tools

Tool	Purpose
`search_emails`	Structured search — free text plus category, sender, date-range, and mailbox filters
`get_email`	Fetch one message’s recipients and full plain-text body
`get_thread`	List every message in a conversation, oldest-first

There are no tools that send, draft, move, or delete email.

Tool	Purpose
`list_calendars`	List calendars with their CalDAV URLs
`create_calendar`	Create a new calendar
`list_calendar_events`	List events, optionally within a time window
`create_calendar_event`	Create an event or recurring series and send invitations
`update_calendar_event`	Replace an event in place and notify attendees
`delete_calendar_event`	Delete an event and send cancellations
`respond_to_event`	RSVP to an invitation — accept, decline, or tentative

Every tool returns a single plain-text content block, formatted for direct agent consumption — compact and stable, no JSON envelope to parse.
List results are numbered and include the identifiers (id, uid, calendarUrl) that downstream tools take.
Search and thread results omit message bodies by design; bodies come from get_email only.
Failures return a text block with the MCP isError flag and a one-line reason, for example Email not found: M123 or Calendar not found: <url>.

Email filters (after, before) take UTC ISO 8601 timestamps ending in Z.
Calendar times (start, end, until) take ISO 8601 with an offset, so events keep their intended local time — 2026-07-14T10:00:00+02:00 or 2026-07-14T08:00:00Z.