ms-contacts-mcp

ms-contacts-mcp

Microsoft Contacts Model Context Protocol server — 7 tools over the Microsoft Graph v1.0 API. Runs over stdio (local) or Streamable HTTP (remote).

Part of microsoft-mcps.

Setup

Sign in once with your own free Microsoft Entra ID app. Register an app as a public client (redirect URI http://localhost, "Allow public client flows" = Yes) and grant these delegated Microsoft Graph permissions: User.Read, Contacts.ReadWrite. Then:

export MICROSOFT_CLIENT_ID=<your-client-id>
npx -y ms-contacts-mcp login              # opens the browser
# npx -y ms-contacts-mcp login --device-code   # headless alternative

The refresh token is cached under ~/.config/microsoft-mcp/ and renewed automatically — no token pasting, no 1-hour expiry.

Use over stdio (e.g. Claude Desktop)

{
  "mcpServers": {
    "microsoft-contacts": {
      "command": "npx",
      "args": ["-y", "ms-contacts-mcp"],
      "env": { "MICROSOFT_CLIENT_ID": "<your-client-id>" }
    }
  }
}

Advanced: set MICROSOFT_ACCESS_TOKEN to supply a pre-acquired Graph token instead of signing in.

Remote (Streamable HTTP)

npx -y ms-contacts-mcp --http --port 3000

Point a Streamable-HTTP MCP client at http://localhost:3000/mcp and send the token per request as Authorization: Bearer <token>.

See the main repo for the full Entra app walkthrough, environment variables, and the tool list.

License

MIT