How do I use ms-graph-dev?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ms-graph-dev build a request to list all users in the tenant" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

ms-graph-dev

by stubbedev

Overview Schema Related Servers Score Discussions

TypeScript

Remote

Microsoft Graph Dev MCP

An MCP server that helps you construct and validate Microsoft Graph REST API calls — no authentication required in the server itself.

Tools are loaded on demand by resource category. Ask about SharePoint and the sites tools appear. Ask about files and the OneDrive tools appear. The server starts lean and grows with your needs, and always knows the required permissions for every operation.

What it does

Constructs valid Graph API request URLs, methods, headers, and bodies
Validates required and optional parameters
Returns required Microsoft Graph permissions (delegated and application) for every operation
Returns ready-to-use fetch code examples
Links to official Microsoft documentation for every operation
Explains cross-cutting concepts: pagination, OData queries, throttling, delta sync, batching, and auth
Loads resource categories on demand — only what you need

Tools

Always available

These tools are loaded immediately — no setup required.

Tool	Description
`list_categories`	List all resource categories and which are currently loaded
`load_category`	Load tools for a category; triggers `tools/list_changed`
`search_graph_api`	Search Graph API endpoints by keyword; returns a `suggestedCategory` to load
`graph_build_batch`	Build a valid `/$batch` request body from up to 20 operations
`graph_explain_pagination`	How `@odata.nextLink` works; iterate all pages of results
`graph_explain_odata`	`$filter`, `$select`, `$expand`, `$orderby`, `$count`, `$search` with examples
`graph_explain_throttling`	429 handling, `Retry-After`, exponential backoff pattern
`graph_explain_delta`	Delta tokens, change tracking, initial sync vs incremental sync
`graph_explain_batch`	JSON batching, `dependsOn`, response handling
`graph_explain_permissions`	Delegated vs application permissions, consent flows, token acquisition

Resource categories (loaded on demand)

Category	Tools	What you get
users	8	Get, list, create, update, delete users; manager; direct reports; delta sync
files	11	OneDrive/SharePoint document library: list, get, upload (<4MB and resumable), create folder, delete, move, copy, search, download URL, delta sync
mail	9	List and get messages, send, create draft, reply, delete, move, list folders, delta sync
calendar	8	List, get, create, update, delete events; find meeting times; get free/busy schedule; delta sync
groups	8	List, get, create, delete groups; list and manage members and owners
notes	8	OneNote notebooks, sections, pages; create and read content
tasks	10	Planner plans and tasks (CRUD); Microsoft To Do lists and tasks
sites	12	SharePoint sites; lists; list items (CRUD); columns
subscriptions	5	Create, list, get, delete, and renew webhook change notification subscriptions

Example tool output

Every tool returns a structured object with the full request details and required permissions:

{
  "endpoint": "https://graph.microsoft.com/v1.0/sites/{siteId}/lists/{listId}/items?expand=fields",
  "method": "GET",
  "headers": {
    "Authorization": "Bearer {token}"
  },
  "pathParams": { "siteId": "contoso.sharepoint.com,abc123", "listId": "list456" },
  "queryParams": { "expand": "fields" },
  "body": null,
  "description": "List items in list list456.",
  "docsUrl": "https://learn.microsoft.com/en-us/graph/api/listitem-list",
  "codeExample": "const response = await fetch('...', { method: 'GET', headers: { Authorization: 'Bearer {token}' } });\nconst data = await response.json();",
  "requiredPermissions": {
    "delegated": ["Sites.Read.All"],
    "application": ["Sites.Read.All"]
  },
  "notes": "Column values are returned under the 'fields' property. This request already includes ?expand=fields. Without it the items array would contain only metadata, not column data."
}

Installation

The recommended way to run this server is via npx — no local install needed.

npx -y @stubbedev/ms-graph-dev-mcp

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "ms-graph-dev": {
      "command": "npx",
      "args": ["-y", "@stubbedev/ms-graph-dev-mcp"]
    }
  }
}

Claude Code (CLI)

claude mcp add ms-graph-dev -- npx -y @stubbedev/ms-graph-dev-mcp

Or add to your project's .mcp.json:

{
  "mcpServers": {
    "ms-graph-dev": {
      "command": "npx",
      "args": ["-y", "@stubbedev/ms-graph-dev-mcp"]
    }
  }
}

Cursor

Open Settings → MCP and add a new server, or edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "ms-graph-dev": {
      "command": "npx",
      "args": ["-y", "@stubbedev/ms-graph-dev-mcp"]
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "ms-graph-dev": {
      "command": "npx",
      "args": ["-y", "@stubbedev/ms-graph-dev-mcp"]
    }
  }
}

Zed

Edit your settings.json (open via Zed → Settings → Open Settings):

{
  "context_servers": {
    "ms-graph-dev": {
      "command": {
        "path": "npx",
        "args": ["-y", "@stubbedev/ms-graph-dev-mcp"]
      }
    }
  }
}

OpenCode

Edit ~/.config/opencode/config.json:

{
  "mcp": {
    "ms-graph-dev": {
      "type": "local",
      "command": ["npx", "-y", "@stubbedev/ms-graph-dev-mcp"]
    }
  }
}

Codex (OpenAI)

Edit ~/.codex/config.json:

{
  "mcpServers": {
    "ms-graph-dev": {
      "command": "npx",
      "args": ["-y", "@stubbedev/ms-graph-dev-mcp"]
    }
  }
}

Development

git clone https://github.com/stubbedev/ms-graph-dev-mcp.git
cd ms-graph-dev-mcp
npm install
npm run build
npm start

For live reload during development:

npm run dev

Test with MCP Inspector

npx @modelcontextprotocol/inspector npx -y @stubbedev/ms-graph-dev-mcp

License

MIT

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

0dRelease cycle

10Releases (12mo)

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/stubbedev/ms-graph-dev-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server