One API for every inbox,
calendar, and thread.

// Connect a mailbox, subscribe to new messages.
import { MailFrom } from "mailfrom";

const mf = new MailFrom({ host: "https://mf.acme.dev" });

const inbox = await mf.grants.connect({
  provider: "google",
  scopes: ["mail.read", "calendar"],
});

for await (const msg of inbox.stream({ since: "now" })) {
  console.log(msg.subject, msg.from);
}

# Connect a mailbox, subscribe to new messages.
from mailfrom import MailFrom

mf = MailFrom(host="https://mf.acme.dev")

inbox = mf.grants.connect(
  provider="google",
  scopes=["mail.read", "calendar"],
)

for msg in inbox.stream(since="now"):
    print(msg.subject, msg.from_)

// Connect a mailbox, subscribe to new messages.
package main

import "mailfrom.dev/sdk"

func main() {
  mf := mailfrom.New("https://mf.acme.dev")
  inbox, _ := mf.Grants.Connect(mailfrom.Google, "mail.read")

  for msg := range inbox.Stream(mailfrom.Now) {
    fmt.Println(msg.Subject, msg.From)
  }
}

# Subscribe to the message stream over SSE.
curl -N "https://mf.acme.dev/v1/grants/usr_7h3/stream" \
  -H "Authorization: Bearer $MF_KEY" \
  -H "Accept: text/event-stream"