Summary
Connects Claude to Microsoft Graph for mail, calendar, contacts, tasks, and OneDrive. You get read and write operations across Outlook's core surfaces: send and search email, manage drafts and folders, create calendar events with recurrence, handle meeting invitations, sync contacts, work with To Do tasks including checklists and attachments, and browse or upload OneDrive files. Works with both personal Microsoft accounts and enterprise Azure AD setups. The enterprise mode unlocks out-of-office settings, inbox rules, and directory search. Built on top of the olkcli command-line tool, so the same device-code auth flow and Graph API coverage applies. Reach for this when you want Claude to interact directly with your Microsoft workspace without switching contexts.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →olk — Microsoft Outlook in Your Terminal
olk is a scriptable CLI and MCP server for Outlook mail, calendars, contacts,
tasks, and OneDrive through Microsoft Graph. It works with personal Outlook.com
accounts and enterprise Microsoft 365 accounts.
Install
brew install rlrghb/tap/olk
# or
go install github.com/rlrghb/olkcli/cmd/olk@latest
The npm package is olkcli; the installed command is olk:
npm install -g olkcli
See macOS notes if macOS asks for Keychain access after an upgrade.
Quick start
olk auth login
olk auth status
olk mail list --json --results-only --select id,subject,from
olk mail search 'from:person@example.com subject:urgent'
olk calendar view --days 7
olk contacts search "Alex"
olk todo lists list
olk drive ls
For work/school accounts and enterprise-only features:
olk auth login --enterprise
Common commands
| Need | Command |
|---|---|
| Check the signed-in account | olk auth status or olk whoami |
| Find message IDs and subjects | olk mail list --json --results-only --select id,subject,from |
| Search mail | olk mail search "from:person@example.com subject:urgent" |
| View the next week | olk calendar view --days 7 |
| Search contacts | olk contacts search "Alex" |
| List task lists | olk todo lists list |
| Browse OneDrive | olk drive ls |
| Send mail | olk mail send --to person@example.com --subject "Hi" --body "Hello" |
| Draft HTML with an inline image | olk mail drafts create --to person@example.com --subject "Steps" --html --body '<img src="cid:steps">' --inline steps=steps.png |
| Synchronize changes | olk changes --json |
| Use JSON for scripts | olk mail list --json --results-only |
| Use as an MCP server | olk mcp |
See the command reference for all commands and flags.
Inline images in HTML drafts
Use a cid: URL in the HTML and supply the matching image with repeatable
--inline CID=PATH flags. This works for new drafts and true threaded reply or
reply-all drafts:
olk mail reply <ID> --draft --html \
--body '<p>See both images:</p><img src="cid:logo"><img src="cid:steps">' \
--inline logo=logo.png --inline steps=steps.png
olk mail drafts create --to person@example.com --subject "Instructions" --html \
--body '<p>Follow these steps:</p><img src="cid:steps">' \
--inline steps=steps.png
Each CID must be unique and referenced by the HTML. Files must be images and
each must be under 3 MB, the Microsoft Graph simple-attachment limit. Draft
commands do not send mail; immediate sends and forwards do not accept
--inline.
Output and scripting
Results are written to stdout; diagnostics and prompts go to stderr.
olk mail list --json --results-only | jq '.[].subject'
olk contacts list --plain
Output modes are JSON (--json), TSV (--plain), and aligned tables by
default. Use --concise to omit large bodies/previews and --select to limit
fields where supported. See scripting and sync.
Safety defaults
- Use
--no-write --no-send --no-inputfor unattended read-only runs. - MCP exposes curated tools and requires explicit opt-in for mutations.
- External mail, calendar, contact, and file text can be wrapped with
--wrap-untrustedfor agent-safe consumption. - Refresh tokens are stored in the OS keychain; access tokens are kept in memory only.
Read the security and privacy guide before connecting an agent or sharing logs.
Documentation
- Command reference
- Authentication and accounts
- Scripting and synchronization
- MCP and AI agents
- Security and privacy
- Enterprise app setup
- Development and releases
- Agent instructions
Contributing
make build
make test
make lint
See development and releases for repository structure, validation, CI, and publishing details.
License
See LICENSE.
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Registryactive
Packageolkcli
TransportSTDIO
UpdatedJun 10, 2026
