outlook-apiMicrosoft Outlook API integration with managed OAuth. Read, send, and manage emails, folders, calendar events, and contacts via Microsoft Graph. Use this skill when users want to interact with Outlook. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Install via ClawdBot CLI:
clawdbot install byungkyu/outlook-apiAccess the Microsoft Outlook API (via Microsoft Graph) with managed OAuth authentication. Read, send, and manage emails, folders, calendar events, and contacts.
# Get user profile
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/outlook/v1.0/me')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOFhttps://gateway.maton.ai/outlook/{native-api-path}Replace {native-api-path} with the actual Microsoft Graph API endpoint path. The gateway proxies requests to graph.microsoft.com and automatically injects your OAuth token.
All requests require the Maton API key in the Authorization header:
Authorization: Bearer $MATON_API_KEYEnvironment Variable: Set your API key as MATON_API_KEY:
export MATON_API_KEY="YOUR_API_KEY"Manage your Microsoft OAuth connections at https://ctrl.maton.ai.
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=outlook&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOFpython <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'outlook'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOFpython <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOFResponse:
{
"connection": {
"connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80",
"status": "ACTIVE",
"creation_time": "2025-12-08T07:20:53.488460Z",
"last_updated_time": "2026-01-31T20:03:32.593153Z",
"url": "https://connect.maton.ai/?session_token=...",
"app": "outlook",
"metadata": {}
}
}Open the returned url in a browser to complete OAuth authorization.
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOFIf you have multiple Outlook connections, specify which one to use with the Maton-Connection header:
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/outlook/v1.0/me')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Maton-Connection', '21fd90f9-5935-43cd-b6c8-bde9d915ca80')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOFIf omitted, the gateway uses the default (oldest) active connection.
GET /outlook/v1.0/meGET /outlook/v1.0/me/mailFoldersGET /outlook/v1.0/me/mailFolders/{folderId}Well-known folder names: Inbox, Drafts, SentItems, DeletedItems, Archive, JunkEmail
POST /outlook/v1.0/me/mailFolders
Content-Type: application/json
{
"displayName": "My Folder"
}DELETE /outlook/v1.0/me/mailFolders/{folderId}GET /outlook/v1.0/me/mailFolders/{folderId}/childFoldersGET /outlook/v1.0/me/messagesFrom specific folder:
GET /outlook/v1.0/me/mailFolders/Inbox/messagesWith query filter:
GET /outlook/v1.0/me/messages?$filter=isRead eq false&$top=10GET /outlook/v1.0/me/messages/{messageId}POST /outlook/v1.0/me/messages
Content-Type: application/json
{
"subject": "Hello",
"body": {
"contentType": "Text",
"content": "This is the email body."
},
"toRecipients": [
{
"emailAddress": {
"address": "recipient@example.com"
}
}
]
}POST /outlook/v1.0/me/sendMail
Content-Type: application/json
{
"message": {
"subject": "Hello",
"body": {
"contentType": "Text",
"content": "This is the email body."
},
"toRecipients": [
{
"emailAddress": {
"address": "recipient@example.com"
}
}
]
},
"saveToSentItems": true
}POST /outlook/v1.0/me/messages/{messageId}/sendPATCH /outlook/v1.0/me/messages/{messageId}
Content-Type: application/json
{
"isRead": true
}DELETE /outlook/v1.0/me/messages/{messageId}POST /outlook/v1.0/me/messages/{messageId}/move
Content-Type: application/json
{
"destinationId": "{folderId}"
}GET /outlook/v1.0/me/calendarsGET /outlook/v1.0/me/calendar/eventsWith date filter:
GET /outlook/v1.0/me/calendar/events?$filter=start/dateTime ge '2024-01-01'&$top=10GET /outlook/v1.0/me/events/{eventId}POST /outlook/v1.0/me/calendar/events
Content-Type: application/json
{
"subject": "Meeting",
"start": {
"dateTime": "2024-01-15T10:00:00",
"timeZone": "UTC"
},
"end": {
"dateTime": "2024-01-15T11:00:00",
"timeZone": "UTC"
},
"attendees": [
{
"emailAddress": {
"address": "attendee@example.com"
},
"type": "required"
}
]
}DELETE /outlook/v1.0/me/events/{eventId}GET /outlook/v1.0/me/contactsGET /outlook/v1.0/me/contacts/{contactId}POST /outlook/v1.0/me/contacts
Content-Type: application/json
{
"givenName": "John",
"surname": "Doe",
"emailAddresses": [
{
"address": "john.doe@example.com"
}
]
}DELETE /outlook/v1.0/me/contacts/{contactId}Use OData query parameters:
$top=10 - Limit results$skip=20 - Skip results (pagination)$select=subject,from - Select specific fields$filter=isRead eq false - Filter results$orderby=receivedDateTime desc - Sort results$search="keyword" - Search contentconst response = await fetch(
'https://gateway.maton.ai/outlook/v1.0/me/messages?$top=10',
{
headers: {
'Authorization': `Bearer ${process.env.MATON_API_KEY}`
}
}
);import os
import requests
response = requests.get(
'https://gateway.maton.ai/outlook/v1.0/me/messages',
headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'},
params={'$top': 10, '$filter': 'isRead eq false'}
)me as the user identifier for the authenticated userText or HTMLInbox, Drafts, SentItems, etc.curl -g when URLs contain brackets (fields[], sort[], records[]) to disable glob parsingjq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments. You may get "Invalid API key" errors when piping.| Status | Meaning |
|--------|---------|
| 400 | Missing Outlook connection |
| 401 | Invalid or missing Maton API key |
| 429 | Rate limited (10 req/sec per account) |
| 4xx/5xx | Passthrough error from Microsoft Graph API |
MATON_API_KEY environment variable is set:echo $MATON_API_KEYpython <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOFoutlook. For example:https://gateway.maton.ai/outlook/v1.0/me/messageshttps://gateway.maton.ai/v1.0/me/messagesGenerated Mar 1, 2026
A customer support team uses the skill to automatically fetch unread emails from a shared inbox, categorize them by urgency, and draft responses based on templates. This reduces manual triage time and ensures timely replies, improving customer satisfaction and operational efficiency.
A sales team leverages the skill to send personalized bulk emails to leads, track responses, and schedule follow-up calendar events. It integrates with CRM systems to sync contact data, enabling targeted campaigns and reducing administrative overhead for sales representatives.
A project management tool uses the skill to sync emails related to specific projects into designated folders, create tasks from email content, and notify team members via calendar invites. This centralizes communication and streamlines collaboration across remote teams.
An HR department automates onboarding by sending welcome emails, scheduling orientation calendar events, and managing contact lists for new hires. It ensures consistent communication, reduces manual errors, and helps new employees integrate smoothly into the company.
Event organizers use the skill to send invitations, manage RSVPs via email responses, and update calendar events with attendee details. It simplifies coordination for conferences or meetings, ensuring all stakeholders are informed and schedules are synchronized.
Offer a subscription-based service that uses the Outlook skill to provide automated email sorting, drafting, and sending features. Target small to medium businesses, charging a monthly fee per user or based on email volume, with potential upsells for advanced analytics.
Provide consulting services to help enterprises integrate the Outlook skill into their existing workflows, such as CRM or project management systems. Charge on a project basis or hourly rates, with ongoing support contracts for maintenance and updates.
Develop a freemium tool that uses the skill for basic email management and calendar syncing, with premium tiers offering advanced features like bulk sending, AI-driven insights, or multi-account support. Monetize through upgrades and in-app purchases.
💬 Integration Tip
Ensure the MATON_API_KEY is securely stored in environment variables and test connection management via the control panel before deploying to production.
Use the mcporter CLI to list, configure, auth, and call MCP servers/tools directly (HTTP or stdio), including ad-hoc servers, config edits, and CLI/type generation.
Connect to 100+ APIs (Google Workspace, Microsoft 365, GitHub, Notion, Slack, Airtable, HubSpot, etc.) with managed OAuth. Use this skill when users want to...
Build, debug, and deploy websites using HTML, CSS, JavaScript, and modern frameworks following production best practices.
YouTube Data API integration with managed OAuth. Search videos, manage playlists, access channel data, and interact with comments. Use this skill when users want to interact with YouTube. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Scaffold, test, document, and debug REST and GraphQL APIs. Use when the user needs to create API endpoints, write integration tests, generate OpenAPI specs, test with curl, mock APIs, or troubleshoot HTTP issues.
Search for jobs across LinkedIn, Indeed, Glassdoor, ZipRecruiter, Google Jobs, Bayt, Naukri, and BDJobs using the JobSpy MCP server.