olk — Microsoft Outlook in Your Terminal

A fast, scriptable CLI and MCP server for Microsoft Outlook and OneDrive via the Microsoft Graph API. Manage email, calendar, contacts, tasks, and OneDrive files from the command line — or expose them to AI agents as curated, read-first tools over the Model Context Protocol.

Works with both personal Microsoft accounts and enterprise (Azure AD / Entra ID) accounts. Zero-config setup with device-code authentication — just run olk auth login and go. For enterprise accounts, use olk auth login --enterprise to enable additional features like out-of-office, inbox rules, and directory search.

Key Capabilities

Mail

• List & read inbox messages with filtering by sender, date, read status
• Send emails with To/CC/BCC, HTML bodies, stdin piping, attachments, importance
• Search using KQL (Keyword Query Language) syntax
• Reply, reply-all, forward messages
• Move messages between folders
• Delete and mark read/unread
• Manage folders: list, create, rename, delete mail folders
• View and download attachments
• Drafts: create, list, send, delete draft messages
• Flags & categories: flag for follow-up, set importance, assign categories, manage category definitions
• Out-of-office: get, set, and disable auto-reply / vacation responder (enterprise only)
• Inbox rules: list, create, and delete server-side mail rules (enterprise only)
• Focused Inbox: filter by --focused or --other classification
• Read receipts: request read receipts with --read-receipt
• Sync & threads: incremental delta sync (mail delta), batch-fetch up to 20 messages by id in one request (mail batch), and full conversation threads (mail thread)

Calendar

• List events with configurable date ranges (default: 7 days ahead)
• Calendar view with expanded recurring event occurrences
• Recurring events displayed with human-readable recurrence patterns
• Create events with location, attendees, all-day, online meeting, and recurrence support
• Update and delete events
• Respond to invitations (accept, decline, tentative)
• List calendars across your account
• Check availability / free-busy lookup for one or more users
• Find meeting times — suggest available slots for multiple attendees (enterprise only)
• Incremental sync of event changes (calendar delta)

Contacts

• List, search, create, update, delete contacts with sorting and pagination
• Fields: name, multiple emails, phone, company, job title, department, manager, birthday, notes, addresses, categories, and more
• Incremental sync of contact changes (contacts delta)

Tasks (Microsoft To Do)

• Manage task lists: list, create, delete task lists
• Create, update, complete, delete tasks with due dates, importance, notes, start dates, reminders, recurrence, and categories
• Checklists: list, create, toggle, update, and delete checklist items within tasks
• Attachments: list, upload, download, and delete task file attachments
• Linked resources: list, create, and delete linked resources on tasks

OneDrive

• Browse files and folders with drive ls [path]
• Search files by name or content
• Download and upload files (simple and resumable for large files)
• Create folders, copy, move, and delete items
• Share files with view or edit links
• Version history for files
• Drive info including quota usage

People / Directory

• Search people by name — returns name, email, job title, department, company. Personal accounts search known contacts; enterprise accounts also search the organization directory

Sync

• olk changes — one call returns a unified delta digest across mail, calendar, and contacts, each with its own resume token
• Per-resource delta commands (mail delta, calendar delta, contacts delta) return only

... View full README on GitHub