I/O Microsoft Graph

Microsoft Graph API client library for Rust
This library is composed of 3 feature-gated layers:
- Low-level I/O-free coroutines: no_std-compatible state machines containing the whole Microsoft Graph REST logic, usable anywhere
- Mid-level light client: a standard, blocking client wrapping a stream you opened yourself
- High-level full client: the light client plus TCP connections and TLS negotiations handled for you
Table of contents
Features
- Mail: folders, messages and attachments, raw MIME downloads, drafts and sending.
- Contacts, calendars and To Do: contact folders, calendars and events, task lists and their tasks.
- Incremental sync: delta queries return only what changed since the last round.
- Batching: up to 20 requests in one HTTP call.
- iCalendar and vCard (
ical,vcardfeatures): events and tasks as iCalendar, contacts as vCard, and back. - Full client: TLS via Rustls (
rustls-ringdefault,rustls-aws) or Native TLS (native-tls).
[!TIP] I/O Microsoft Graph is written in Rust and uses cargo features to gate the client layers. The default feature set is declared in Cargo.toml or on docs.rs.
API coverage
Microsoft Graph is a single API spanning many domains; io-msgraph covers it incrementally, mirroring the Microsoft Graph v1.0 reference. Every operation below is an I/O-free coroutine.
| Resource | Operations |
|---|---|
| $batch | send up to 20 requests in one HTTP call |
| users | get the signed-in user profile; sendMail action (JSON and MIME form) |
| users.mailFolders | list, get, create, update, delete, move, copy, list child folders |
| users.messages | list, get, get raw MIME, create draft from JSON or MIME, update, delete, move, copy, send, track changes with delta |
| users.messages.attachments | list, create, get raw content, delete |
| users.contactFolders | list, get, create, update, delete, list child folders |
| users.contacts | list, get, create, update, delete, track changes with delta |
| users.calendars | list, get, create, update, delete |
| users.events | list, get, create, update, delete, list instances, calendar view, track changes with delta |
| users.todo.lists | list, get, create, update, delete, track changes with delta |
| users.todo.lists.tasks | list, get, create, update, delete, track changes with delta, list checklist items |
Usage
See documentation at docs.rs.
Examples
See complete examples at ./tests.
Have also a look at real-world projects built on top of this library:
- Himalaya CLI: CLI to manage emails
- Cardamum CLI: CLI to manage contacts
License
This project is licensed under either of:
Social
- Chat on Matrix
- News on Mastodon or RSS
- Mail at pimalaya.org@posteo.net
Sponsoring
Special thanks to the NLnet foundation and the European Commission that have been financially supporting the project for years:
- 2022 → 2023: NGI Assure
- 2023 → 2024: NGI Zero Entrust
- 2024 → 2026: NGI Zero Core
- 2026 → 2027: NGI Zero Commons Fund
This program is part of Pimalaya, free software funded entirely by grants and donations. If you find it useful, consider sponsoring its development:
