OAuth 2.0 client for Microsoft Graph with multi-account support, PKCE security, and swappable storage backends
npm install @mcp-z/oauth-microsoft keyv keyv-file
/oauth/callback URL. Local HTTP uses the port configured by the server.http://localhost for the ephemeral redirect URL.import { LoopbackOAuthProvider } from '@mcp-z/oauth-microsoft';
import Keyv from 'keyv';
import { KeyvFile } from 'keyv-file';
const provider = new LoopbackOAuthProvider({
service: 'outlook',
clientId: process.env.MS_CLIENT_ID!,
tenantId: process.env.MS_TENANT_ID || 'common',
scope: 'https://graph.microsoft.com/Mail.Read offline_access',
tokenStore: new Keyv({ store: new KeyvFile({ filename: '.tokens/microsoft.json' }) })
});
const accessToken = await provider.getAccessToken();
// Opens the browser for consent when no valid token is stored, then returns a token.
import { DeviceCodeProvider } from '@mcp-z/oauth-microsoft';
import Keyv from 'keyv';
import { KeyvFile } from 'keyv-file';
const provider = new DeviceCodeProvider({
service: 'outlook',
clientId: process.env.MS_CLIENT_ID!,
tenantId: process.env.MS_TENANT_ID || 'common',
scope: 'https://graph.microsoft.com/Mail.Read offline_access',
tokenStore: new Keyv({ store: new KeyvFile({ filename: '.tokens/microsoft.json' }) })
});
const accessToken = await provider.getAccessToken();
// Prints a device code and verification URL for headless sign-in when needed.
Use DcrOAuthProvider for bearer validation and createDcrRouter to host the DCR endpoints and accept CIMD clients. CIMD resolution uses the secure shared resolver by default. A custom cimdResolver can be supplied for an explicit local-development policy; production deployments should additionally use an egress proxy.
import { DcrOAuthProvider, createDcrRouter } from '@mcp-z/oauth-microsoft';
const provider = new DcrOAuthProvider({
clientId: process.env.MS_CLIENT_ID!,
clientSecret: process.env.MS_CLIENT_SECRET!,
scope: 'openid email profile',
verifyEndpoint: 'https://your-host.com/oauth/verify'
});
const router = createDcrRouter({
store,
issuerUrl: 'https://your-host.com',
baseUrl: 'https://your-host.com',
scopesSupported: ['openid', 'email', 'profile'],
clientConfig: {
clientId: process.env.MS_CLIENT_ID!,
clientSecret: process.env.MS_CLIENT_SECRET!
}
});
For local development, configure the resolver explicitly with its loopback and HTTP opt-ins:
import { createCimdResolver } from '@mcp-z/oauth';
import { createDcrRouter } from '@mcp-z/oauth-microsoft';
const router = createDcrRouter({ ...config, cimdResolver: createCimdResolver({ allowHttpLoopback: true }) });
Use parseConfig() and parseDcrConfig() to load CLI + env settings for servers.
schemas - Shared Zod schemas used by toolsEnrichedExtra - Handler extra type with auth context