DocsOutlook

Outlook

Give your agents full Outlook access via Microsoft Graph API. Read, search, send, and manage emails.

Quick Start

quickstart.py
python
from connectonion import Agent, Outlook

outlook = Outlook()
agent = Agent("assistant", tools=[outlook])

agent.input("Show me my recent emails")
agent.input("Send an email to alice@example.com saying hello")

Setup

Authenticate with Microsoft:

Terminalbash

$co auth microsoft

Your agent can now read and manage Outlook emails.

Agent Methods

Reading Emails

read_inbox(last=10, unread=False)

Read emails from inbox

last - Number of emails (default: 10)
unread - Only unread emails (default: False)

get_sent_emails(max_results=10)

Get emails you sent

get_email_body(email_id)

Get full email content with headers

Search

search_emails(query, max_results=10)

Search emails using Microsoft Graph search

Example queries:

"quarterly report"
"meeting notes"
"invoice"

Sending Emails

send(to, subject, body, cc=None, bcc=None)

Send email via Microsoft Graph API

to - Recipient email (comma-separated for multiple)
subject - Email subject
body - Email body (plain text)
cc - Optional CC recipients
bcc - Optional BCC recipients

reply(email_id, body)

Reply to an existing email

Actions

mark_read(email_id)

Mark email as read

mark_unread(email_id)

Mark email as unread

archive_email(email_id)

Move email to archive folder

Stats

count_unread()

Count unread emails in inbox

get_my_email()

Get connected Microsoft email address

Complete Example

complete_example.py
python
from connectonion import Agent, Outlook, Memory

outlook = Outlook()
memory = Memory()

agent = Agent(
    name="email-assistant",
    tools=[outlook, memory],
    system_prompt="You help manage Outlook emails and remember important info."
)

# Various tasks your agent can now do:
agent.input("Check unread emails and summarize them")
agent.input("Send an email to alice@example.com about the project update")
agent.input("Find all emails about the quarterly report")
agent.input("How many unread emails do I have?")

Troubleshooting

Missing Microsoft Mail scopes

Run co auth microsoft

Credentials not found

Run co auth microsoft

Token expired

Tokens auto-refresh. If issues persist, run co auth microsoft again.

Microsoft Integration

Full OAuth setup and calendar integration

Gmail

Gmail integration for Google users

Outlook

Quick Start

Setup

Agent Methods

Reading Emails

read_inbox(last=10, unread=False)

get_sent_emails(max_results=10)

get_email_body(email_id)

Search

search_emails(query, max_results=10)

Sending Emails

send(to, subject, body, cc=None, bcc=None)

reply(email_id, body)

Actions

mark_read(email_id)

mark_unread(email_id)

archive_email(email_id)

Stats

count_unread()

get_my_email()

Complete Example

Troubleshooting

Missing Microsoft Mail scopes

Credentials not found

Token expired

Related

Microsoft Integration

Gmail

Star us on GitHub