Microsoft Graph API助手工具包

# Add Microsoft MCP server (replace with your Azure app ID)
claude mcp add microsoft-mcp -e MICROSOFT_MCP_CLIENT_ID=your-app-id-here -- uvx --from git+https://github.com/elyxlz/microsoft-mcp.git microsoft-mcp

# Start Claude Desktop
claude

# Email examples
> read my latest emails with full content
> reply to the email from John saying "I'll review this today"
> send an email with attachment to alice@example.com

# Professional email templates
> send a practice report for Baytown location with this month's financial data
> send an executive summary across all locations
> send a provider performance update for Dr. Johnson
> send an alert notification about system downtime

# Calendar examples  
> show my calendar for next week
> check if I'm free tomorrow at 2pm
> create a meeting with Bob next Monday at 10am

# File examples
> list files in my OneDrive
> upload this report to OneDrive
> search for "project proposal" across all my files

# Multi-account
> list all my Microsoft accounts
> send email from my work account

git clone https://github.com/elyxlz/microsoft-mcp.git
cd microsoft-mcp
uv sync

# Set your Azure app ID
export MICROSOFT_MCP_CLIENT_ID="your-app-id-here"

# Run authentication script
uv run authenticate.py

# Follow the prompts to authenticate your Microsoft accounts

{
  "mcpServers": {
    "microsoft": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/elyxlz/microsoft-mcp.git", "microsoft-mcp"],
      "env": {
        "MICROSOFT_MCP_CLIENT_ID": "your-app-id-here"
      }
    }
  }
}

{
  "mcpServers": {
    "microsoft": {
      "command": "uv",
      "args": ["--directory", "/path/to/microsoft-mcp", "run", "microsoft-mcp"],
      "env": {
        "MICROSOFT_MCP_CLIENT_ID": "your-app-id-here"
      }
    }
  }
}

# List accounts to get IDs
accounts = list_accounts()
account_id = accounts[0]["account_id"]

# Use account for operations
send_email(account_id, "user@example.com", "Subject", "Body")
list_emails(account_id, limit=10, include_body=True)
create_event(account_id, "Meeting", "2024-01-15T10:00:00Z", "2024-01-15T11:00:00Z")

# Or via username or 'default'
list_emails("admin@contoso.com", limit=10, include_body=True)
list_emails("default", limit=10, include_body=True)

await send_practice_report(
    account_id="default",
    to="manager@kamdental.com",
    subject="Baytown Practice Report - January 2024",
    location="Baytown",
    financial_data={
        "production": {"value": 285000, "goal": 300000},
        "collections": {"value": 270000, "ratio": 0.947},
        "case_acceptance": {"value": 0.72, "goal": 0.75},
        "call_answer_rate": {"value": 0.91, "goal": 0.95}
    },
    provider_data=[
        {
            "name": "Dr. Sarah Johnson",
            "role": "General Dentist",
            "production": 125000,
            "goal_percentage": 1.04
        }
    ],
    period="January 2024",
    alerts=[
        {
            "type": "warning",
            "title": "Production Below Target",
            "message": "Current production is 5% below monthly target."
        }
    ]
)

await send_executive_summary(
    account_id="default",
    to="executive@kamdental.com",
    locations_data=[
        {
            "name": "Baytown",
            "production": 285000,
            "target": 300000,
            "status": "warning"
        },
        {
            "name": "Humble",
            "production": 195000,
            "target": 180000,
            "status": "ahead"
        }
    ],
    period="Q1 2024",
    key_insights=[
        {
            "title": "Overall Performance",
            "description": "Combined production at 96% of target"
        }
    ]
)

# Run tests
uv run pytest tests/ -v

# Type checking
uv run pyright

# Format code
uvx ruff format .

# Lint
uvx ruff check --fix --unsafe-fixes .

# Test email framework
uv run python -m microsoft_mcp.email_framework.test_runner

[mcp_servers.microsoft]
command = "uvx"
args = [
  "--from",
  "git+https://github.com/elyxlz/microsoft-mcp.git",
  "microsoft-mcp",
]
env = { "MICROSOFT_MCP_CLIENT_ID" = "your-azure-app-id", "MICROSOFT_MCP_TENANT_ID" = "common" }

[mcp_servers.microsoft]
command = "uv"
args = ["--directory", "/path/to/microsoft-mcp", "run", "microsoft-mcp"]
env = { "MICROSOFT_MCP_CLIENT_ID" = "your-azure-app-id", "MICROSOFT_MCP_TENANT_ID" = "common" }

# Get account ID first
accounts = list_accounts()
account_id = accounts[0]["account_id"]

# List latest emails with full content
emails = list_emails(account_id, limit=10, include_body=True)

# Reply maintaining thread
reply_to_email(account_id, email_id, "Thanks for your message. I'll review and get back to you.")

# Forward with attachments
email = get_email(email_id, account_id)
attachments = [get_attachment(email_id, att["id"], account_id) for att in email["attachments"]]
send_email(account_id, "boss@company.com", f"FW: {email['subject']}", email["body"]["content"], attachments=attachments)

# Get account ID first
accounts = list_accounts()
account_id = accounts[0]["account_id"]

# Check availability before scheduling
availability = check_availability(account_id, "2024-01-15T10:00:00Z", "2024-01-15T18:00:00Z", ["colleague@company.com"])

# Create meeting with details
create_event(
    account_id,
    "Project Review",
    "2024-01-15T14:00:00Z", 
    "2024-01-15T15:00:00Z",
    location="Conference Room A",
    body="Quarterly review of project progress",
    attendees=["colleague@company.com", "manager@company.com"]
)