Free & open source · MIT

Talk to Microsoft 365
from Claude, Cursor & VS Code

Mail, calendar, files, Teams, users, SharePoint, Planner, OneNote — through one tiny MCP server. Download the macOS app, paste your Azure credentials, click Start. Your AI does the rest.

Apple Silicon · signed & notarized No terminal needed Credentials stored encrypted
Lazy MS Graph MCP — Overview
The Lazy MS Graph MCP macOS app showing the server running, 2 tenants configured, and live logs
How easy is it?

Up and running in three clicks

No config files to hand-edit, no build step, no terminal. The app validates your credentials, starts the server, and writes the MCP config for your editor.

1

Download & open the app

Grab the DMG, drag it to Applications. It lives in your menu bar, auto-starts with macOS if you want, and keeps running in the tray.

~30 seconds
2

Paste your Azure credentials

Client ID, secret, tenant ID. The built-in Guide walks you through the Azure portal, tells you exactly which permission each tool needs, and validates the credentials before the server starts.

~2 minutes, once
3

Click “Install for Claude Code”

Or Cursor, or copy the VS Code snippet. The Connect page writes the MCP entry for you — including the full tenant roster if you have more than one. Then just ask your AI.

1 click
✕ npm install ✕ editing JSON by hand ✕ secrets in plain-text env files ✓ Start · Install · done

One-click server

Start/Stop lives in the header with a status pill and uptime, visible from every page. Live, clearable logs on the Overview.

Multiple Entra ID tenants

Add several app registrations. Give each a description — “use for the Client X project” — and the AI picks the right tenant on its own.

Encrypted credentials

Secrets are stored with Electron safeStorage, backed by the macOS Keychain. They never sit in a plain-text file.

Auto-install for your editor

One button for Claude Code, one for Cursor, a copy-ready snippet for VS Code. Multi-tenant configs included.

Searchable tool catalog

The Tools page renders the real catalog from the bundled server. Search by name, category, or description.

Built-in Azure AD guide

Step-by-step app registration with a per-tool permission map, so you grant exactly what you need and nothing more.

Screenshots

A small app that stays out of your way

Sidebar layout: Overview, Tenants, Connect, Tools — plus Guide and Settings. Everything you need, nothing you don't.

Overview

Transport, port, and tool count at a glance. Tenant chips show which profile is the default and which use delegated auth. Logs stream live from the server process.

  • Status pill with uptime, Start / Stop always in reach
  • Tenant chips link straight to the Tenants page
  • “Apply & Restart” banner when config changes while running
Overview
Overview page with stat cards for transport, port and tool count, tenant chips, and live logs

Tenants

Each profile is one Azure AD app registration. The description you write here is surfaced to the AI through tenants_list and baked into the execute_tool schema — so “check the Client X SharePoint” routes to the right tenant without you saying which.

  • Add, edit, delete; set the default; two-step delete confirm
  • App-only or delegated auth per tenant
  • Secrets are masked — the AI never sees them
Tenants
Tenants page listing two Entra ID tenant profiles, corp (default, app-only) and clientx (delegated), each with an AI-facing description
Use cases

Things you can just ask

You type a sentence. Your assistant finds the right Graph tool, fills in the parameters, and runs it. A few examples and the tools they chain together.

Inbox triage

Summarise every unread email from this week that mentions the budget.

mail_search_messages→mail_get_message

Searches subject, body and metadata; pulls full bodies only for the hits.

Scheduling

Find a 30-minute slot with Priya and Tom on Thursday and book it.

calendar_find_free_busy→calendar_create_event

Free/busy across several users, then a real invite with attendees.

Sharing

Share the Q3 deck from my OneDrive with the #sales channel in Teams.

files_search→files_share→teams_send_message

Finds the file, creates a sharing link, posts it to the channel.

Directory admin

Who's in the Finance group? Add Sam Lee and remove anyone who left.

groups_list→groups_list_members→groups_manage_members

Membership changes with the same tools your IT team would script.

Onboarding

Create an account for our new hire and add them to Engineering and All-Staff.

users_create→groups_manage_members

Requires User.ReadWrite.All — the app's guide tells you before you try.

Project tracking

Add a “Ship release notes” task to the Launch plan, due Friday, assigned to me.

planner_list_plans→planner_create_task

Etag-aware updates so concurrent edits don't clobber each other.

Notes

Pull the action items from last week's retro page in OneNote.

onenote_list_notebooks→onenote_list_pages→onenote_get_page_content

Returns the page HTML; the AI extracts the list.

Multi-tenant

List the open items in the Client X “Deliverables” SharePoint list.

tenant: clientx→sharepoint_list_lists→sharepoint_get_list_items

The tenant description says “use for anything about Client X” — the AI routes there automatically.

How it works

Two MCP tools. Fifty-six operations.

Most Graph MCP servers dump dozens of tools into your assistant's context. Lazy MS Graph exposes just search_tools and execute_tool, and lets the AI discover the rest by category.

you“Send an email to John about the meeting”
search_toolscategory: mail → 8 tools with their Zod-typed parameters
execute_toolmail_send_message with subject, body, recipients (+ optional tenant)
Microsoft GraphOAuth 2.0 client-credentials via MSAL, token refresh handled for you
what the AI actually does
You:  Send an email to john@company.com about the meeting

AI:   → search_tools({ query: "*", category: "mail" })
      ← mail_list_messages, mail_get_message,
        mail_send_message, mail_reply_message,
        mail_forward_message, mail_search_messages,
        mail_list_folders, mail_create_folder

AI:   → execute_tool({
          tool_name:  "mail_send_message",
          parameters: {
            userId:       "me",
            subject:      "About the meeting",
            body:         "…",
            toRecipients: ["john@company.com"]
          }
        })
      ← ✓ sent
2

tools in your MCP context — no matter how many other servers you have loaded. Your assistant stays sharp.

11

categories with category-first routing, so the AI narrows to the right family of tools before it picks one.

stdio · SSE

Run over stdio for editors, or as an HTTP server with /sse, /messages and /health endpoints.

Multiple tenants

Consultants, agencies, MSPs: one server, every client

Hold several Entra ID app registrations at once. Each carries a description — “when should the AI use this tenant?” — that is baked into the execute_tool schema at startup. The assistant routes on it without an extra lookup.

  • · Pass tenant: "fabrikam" on any call, or let the default apply
  • · tenants_list, tenants_get_current, tenants_switch from the assistant
  • · Configure in the app, via MSGRAPH_TENANTS JSON, a file, or per-tenant env vars
  • · Legacy single-tenant vars still work as the default profile
MSGRAPH_TENANTS
[
  { "name": "contoso",  "clientId": "…", "clientSecret": "…", "tenantId": "…",
    "description": "Main company tenant — use unless another is named." },
  { "name": "fabrikam", "clientId": "…", "clientSecret": "…", "tenantId": "…",
    "description": "Fabrikam engagement — anything about the Fabrikam project." }
]
Tenants
Tenants page in the app
Tool catalog

56 tools across 11 categories

Everything the server registers, straight from the source. Each tool has typed, validated parameters and a description the AI uses to choose it.

mail

8 tools

Read, search, send, reply, forward; manage folders.

mail_list_messagesmail_get_messagemail_send_messagemail_reply_messagemail_forward_messagemail_search_messagesmail_list_foldersmail_create_folder

calendar

6 tools

Events in a date range, CRUD, and free/busy across users.

calendar_list_eventscalendar_get_eventcalendar_create_eventcalendar_update_eventcalendar_delete_eventcalendar_find_free_busy

files

6 tools

OneDrive: browse, search content, upload, download links, share.

files_listfiles_getfiles_uploadfiles_downloadfiles_searchfiles_share

users

5 tools

Directory users with OData filtering, select, search, paging.

users_listusers_getusers_createusers_updateusers_delete

teams

5 tools

Teams, channels, and channel messages — read and post.

teams_listteams_list_channelsteams_list_messagesteams_send_messageteams_get_message

groups

5 tools

Microsoft 365 & security groups and their membership.

groups_listgroups_getgroups_creategroups_list_membersgroups_manage_members

contacts

5 tools

Personal contacts for a user, full CRUD.

contacts_listcontacts_getcontacts_createcontacts_updatecontacts_delete

planner

5 tools

Plans for a group, tasks with etag-safe updates.

planner_list_plansplanner_get_planplanner_list_tasksplanner_create_taskplanner_update_task

sharepoint

4 tools

Sites, lists, and list items with expanded field values.

sharepoint_list_sitessharepoint_get_sitesharepoint_list_listssharepoint_get_list_items

onenote

4 tools

Notebooks → sections → pages → page HTML.

onenote_list_notebooksonenote_list_sectionsonenote_list_pagesonenote_get_page_content

tenants

3 tools

Inspect and switch Entra ID profiles from the assistant.

tenants_listtenants_get_currenttenants_switch

The macOS app bundles a slightly larger build — 63 tools across 13 categories — adding a chats category (1:1 and group Teams chats) and an advanced category with a raw graph_request escape hatch for any Graph endpoint.

Prefer the command line?

Run the server yourself

The app is the easy path, but the server is plain Node.js. Clone, build, point your editor at dist/index.js.

1 · Clone and build

bash
git clone https://github.com/sagarmk/lazy-mcirosoft-mcp.git
cd lazy-mcirosoft-mcp
npm install
npm run build

2 · Run it

bash
MSGRAPH_CLIENT_ID="your-client-id" \
MSGRAPH_CLIENT_SECRET="your-client-secret" \
MSGRAPH_TENANT_ID="your-tenant-id" \
npm start

Optional: MSGRAPH_MCP_TRANSPORT=sse and MSGRAPH_MCP_PORT=3100 for HTTP mode. node dist/index.js --print-tools dumps the catalog as JSON with no credentials.

3 · Add to your editor

One command from any terminal:

bash
claude mcp add lazy-ms-graph \
  -e MSGRAPH_CLIENT_ID=your-client-id \
  -e MSGRAPH_CLIENT_SECRET=your-client-secret \
  -e MSGRAPH_TENANT_ID=your-tenant-id \
  -- node /path/to/lazy-mcirosoft-mcp/packages/server/dist/index.js

~/Library/Application Support/Claude/claude_desktop_config.json

json
{
  "mcpServers": {
    "lazy-ms-graph": {
      "command": "node",
      "args": ["/path/to/lazy-mcirosoft-mcp/packages/server/dist/index.js"],
      "env": {
        "MSGRAPH_CLIENT_ID": "your-client-id",
        "MSGRAPH_CLIENT_SECRET": "your-client-secret",
        "MSGRAPH_TENANT_ID": "your-tenant-id"
      }
    }
  }
}

~/.cursor/mcp.json

json
{
  "mcpServers": {
    "lazy-ms-graph": {
      "command": "node",
      "args": ["/path/to/lazy-mcirosoft-mcp/packages/server/dist/index.js"],
      "env": {
        "MSGRAPH_CLIENT_ID": "your-client-id",
        "MSGRAPH_CLIENT_SECRET": "your-client-secret",
        "MSGRAPH_TENANT_ID": "your-tenant-id"
      }
    }
  }
}

.vscode/mcp.json (project) or your user settings JSON

json
{
  "servers": {
    "lazy-ms-graph": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/lazy-mcirosoft-mcp/packages/server/dist/index.js"],
      "env": {
        "MSGRAPH_CLIENT_ID": "your-client-id",
        "MSGRAPH_CLIENT_SECRET": "your-client-secret",
        "MSGRAPH_TENANT_ID": "your-tenant-id"
      }
    }
  }
}
Azure AD setup

One app registration, five minutes

You do this once in the Azure portal. The app's built-in Guide shows the same steps with a per-tool permission map.

1 · Register an app

  1. portal.azure.com → App registrations → New registration
  2. Name it anything, e.g. “Lazy MS Graph MCP”
  3. Copy the Application (client) ID and Directory (tenant) ID

2 · Create a client secret

  1. Certificates & secrets → New client secret
  2. Copy the Value right away — it's shown once

3 · Grant Application permissions

  1. API permissions → Add a permission → Microsoft Graph → Application permissions
  2. Add what you need, then Grant admin consent
User.Read.AllMail.ReadMail.SendCalendars.ReadWriteFiles.ReadWrite.AllTeam.ReadBasic.All
Application permissions, not Delegated. The server authenticates with client credentials. Delegated permissions will not work and every call will return 403. If that's what you're seeing, this is why.

Useful? Give it a star.

Stars help other people find the project — and keep it maintained.

Star on GitHub