oto.cx
outlook

microsoft

outlook.

A message in the person's Outlook mailbox — search, read, fetch an

add to otoauth : —prefix : outlook_*

setup & usage

⚠ connect with your Microsoft 365 account

on the "Outlook" card, click Authorize Outlook and choose your work account. Nothing else to install or register. The account itself is the "Microsoft 365 account" connector: Outlook borrows it and only adds its own permissions (read and write your mail, send it).

  • the agent acts with your rights, in your mailbox: it reads what you can read, and what it sends leaves from your address. Each person in the org connects their own account
  • work or school accounts only; a guest of a client's Microsoft 365 fills in Client directory at connection (the client's domain; see the "Microsoft 365 account" connector)
  • ⚠️ many organizations require a Microsoft 365 administrator to authorize oto a first time. If Microsoft shows "admin approval required", the card comes back with that reason: an administrator approves oto once for the whole organization (microsoft_admin_consent, see the "Microsoft 365 account" connector), then everyone can connect
  • an account already linked for another Microsoft service (SharePoint, the calendar…) only needs to authorize this one; an account that has not authorized Outlook is refused by the tools, naming this card
  • the connection lasts over time; it drops if the password changes, if the organization revokes it or after a long inactivity: the card then says which account is "to reconnect", the others keep working
    • ▸ search, read, draft, send

    outlook_message(op=search|get|attachment|drafts|folders|archive|trash|move) and outlook_compose, under the account the call names (_account="me@fabrikam.com"), otherwise the default one.

  • "this week's unread emails" → outlook_message(unread=true); "the invoices from Jane" → outlook_message(query="from:jane invoice")
  • "read this email" → outlook_message(op="get", message_id="…"): its text and its attachments; "open the PDF attached" → op="attachment" with attachment_id or filename — a PDF or a text comes back as text, an Excel as CSV
  • "draft a reply" → outlook_compose(reply_to="…", body="…"); "send it" → the same with mode="send"
  • "write to Marc with the contract" → outlook_compose(to=["marc@…"], subject="…", body="…", attachments=[{"kind":"drive","file_id":"…"}]) — a draft unless mode="send"
  • "archive the newsletters" → outlook_message(op="archive", message_ids=[…]); op="trash" moves to Deleted Items, op="move" to any folder (op="folders" lists them)
  • each response is a trimmed view; full=true returns the complete Microsoft Graph object, fields=[…] keeps only some keys of each message
    • · what is misleading
  • ⚠️ a draft is the default: outlook_compose sends only with mode="send". Its answer says kind: draft (saved in Drafts, nothing left) or sent
  • ⚠️ no signature is added: Microsoft does not let an application read your Outlook signature. Write the sign-off in the body
  • ⚠️ a moved message changes id (archive, trash, move): the answer gives new_id — the old id no longer exists
  • a search (query) cannot be combined with unread: Microsoft refuses it. Put the condition in the query, or list without one
  • a search comes back in Microsoft's order (most recent first), from its index: a message received seconds ago may not be found yet
  • an attachment is limited to 3 MB when writing; reading one has the usual limits
    • · scope

    mail only: search, read, attachments, drafts, replies, sending, archive, trash, move between folders. Nothing deletes a message for good, nothing changes rules, categories or the signature. The calendar is the "Outlook Calendar" connector.

    ⚙ multiple comptes

    this connector accepts multiple comptes: connecting with another compte adds it alongside the others, named by its address; reconnecting with the same one replaces its own.

  • the first linked compte is the default
  • without specification, the agent takes the only linked compte, otherwise the one marked as default; otherwise the call is refused, naming the available comptes — never a random choice
  • target a compte for a call: _account="<name>" on the tool; list them: oto_identity(op='list', connector='outlook')
  • set the default: oto_identity(op='set', connector='outlook', identity_id='<name>')
  • ⚠️ no tool walks through the comptes on its own: a total across several comptes is obtained by calling each one (_account) and adding up

    • outils

    chargement…

    usage

    claude code — install the oto plugin — claude plugin marketplace add otomata-tech/oto-plugin — mcp + skill configured.
    claude.ai — add mcp.oto.cx/mcp as a custom connector (guide)
    cli — pipx install oto-cli then oto outlook …
    ← tous les connecteurscatalogue mcp →