OutNote
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
For educational and research purposes only. Use it solely against accounts you own or with the explicit authorization of the account/tenant owner. It drives a real sign-in with real credentials - treat the cookie jar and any tokens like passwords. See the Disclaimer below.
What is OutNote?
Every "read my mailbox over Graph" tutorial makes you register an Azure app and get admin consent - which a locked-down tenant (a school, a company) simply refuses. OutNote sidesteps that entirely.
It signs in (via entrance) with the pre-consented OfficeHome first-party client, gets a FOCI family refresh token, and a broker trades it for whichever first-party client's token a given call needs - all without another sign-in, and each already consented in the tenant. One headless login (password + TOTP, no browser), then clean reads and writes across the whole account.
Related MCP server: outlook-mac-mcp
Features
🔓 No app registration, no admin consent - rides pre-consented Microsoft first-party clients
🤖 Fully headless - password + TOTP MFA over pure HTTP (or a browser fallback via
entrance)💾 Log in once - the family refresh token is persisted (0600) and reused, so later runs skip the sign-in
📬 Broad coverage - mail, calendar, Teams chats & channels, OneDrive, SharePoint, OneNote, To Do, Planner, Assignments
✉️ Writes too - send mail, Teams messages (with @mentions), events, uploads, OneNote pages, tasks
🧾 Text out - Teams/OneNote HTML to text,
.docx/.pptx/.xlsx/.pdfextraction⚡ Fast and robust - stateless by default, optional sync and caching, 429/5xx backoff,
$batch, delta queries🖥️ CLI -
outnote --text chats --unread
Install
pip install outnote # or: uv add outnotePython 3.11+; ms-entrance is pulled in automatically. pip install "outnote[pdf]" adds PDF text extraction.
Quickstart
from outnote import authenticate
note = authenticate("you@school.ch", "password", totp_secret="JBSWY3DPEHPK3PXP")
note.emails(top=5, unread=True)
note.chats()
note.send_to("friend@school.ch", "on my way")
note.download(item_id)
note.search_emails("invoice")Docs
Usage - sign-in, reading, writing, the CLI
Method reference - every method, its endpoint, and the caveats
FOCI clients - the client/scope map and how to re-probe your tenant
Disclaimer
OutNote is published for educational and research purposes only - to document how Microsoft 365's first-party OAuth2 clients and the Graph API behave for a browserless client.
Use it only against accounts you own, or with the explicit authorization of the account or tenant owner. You alone are responsible for your use of it and for complying with Microsoft's terms, your identity provider's terms, your institution's acceptable-use policy, and applicable law. The software is provided "as is", without warranty of any kind, and the author accepts no liability for misuse. Not affiliated with or endorsed by Microsoft.
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Permissioned access to Outlook, OneDrive and Teams via the user's own Microsoft account
Manage Microsoft 365 email, calendar, contacts and inbox rules via the Graph API with OAuth 2.0.
Read email/chat conversations, messages, contacts and teams; draft, send and update threads.
Hosted email MCP for your own Gmail, Outlook.com, Microsoft 365, iCloud or IMAP inbox: read, search, draft, reply in thread, forward and file mail. It moves or flags up to 500 messages in one call, and a send leaves exactly one copy in Sent. A calendar is a separate connection, and connecting one adds diary and scheduling tools.
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server for Microsoft 365 via the Microsoft Graph API, providing read-only access to profile, calendar, email, Teams chats, OneDrive files, and meeting transcripts from any MCP client.17221 npm3MIT
- AlicenseNot gradedqualityBmaintenanceEnables read-only access to personal Microsoft Outlook mail, calendar, and contacts via the Microsoft Graph API using device-code authentication, without requiring the Outlook desktop app.MIT
- AlicenseNot gradedqualityBmaintenanceEnables authenticated interaction with Microsoft 365 and Office services through the Graph API, covering email, calendar, files, Teams, SharePoint, and more. Supports read-only mode, tool filtering, presets, and multiple cloud environments for safe, controlled access.125,353 npmMIT
- AlicenseBqualityBmaintenanceEnables AI clients to read, search, send and triage Microsoft 365 mail, manage folders, attachments and drafts, and work with calendar events and contacts by calling the same internal API the Outlook web app uses, with no Graph app registration or admin consent. Supports Azure CLI token refresh, a read-only mode, and compact normalized JSON output.40MIT