Outlook create draft

outlook__create_draft

Access

Requires a project integration connection for outlook.

Call type: Can change resources.

Arguments

FieldTypeRequiredDescription and constraints
subjectstringYesMessage subject
bodyobjectYesMicrosoft Graph itemBody object, for example { contentType, content }
toRecipientsvalue[]YesMicrosoft Graph recipient array
ccRecipientsvalue[]NoCC recipient array
bccRecipientsvalue[]NoBCC recipient array
replyTovalue[]NoReply-to recipient array
importancestringNoMessage importance: low, normal, or high
categoriesvalue[]NoOutlook category names

Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "outlook__create_draft",
    "arguments": {
      "subject": "example",
      "body": {},
      "toRecipients": []
    }
  }
}

Result

No output schema is published for this tool. The input contract does not define its return fields. Inspect the MCP response content and isError; do not assume a fixed object shape. See the outlook integration reference for provider setup and tool context.

Full schemas

json
{
  "type": "object",
  "properties": {
    "subject": {
      "type": "string",
      "description": "Message subject"
    },
    "body": {
      "type": "object",
      "description": "Microsoft Graph itemBody object, for example { contentType, content }"
    },
    "toRecipients": {
      "type": "array",
      "description": "Microsoft Graph recipient array"
    },
    "ccRecipients": {
      "type": "array",
      "description": "CC recipient array"
    },
    "bccRecipients": {
      "type": "array",
      "description": "BCC recipient array"
    },
    "replyTo": {
      "type": "array",
      "description": "Reply-to recipient array"
    },
    "importance": {
      "type": "string",
      "description": "Message importance: low, normal, or high"
    },
    "categories": {
      "type": "array",
      "description": "Outlook category names"
    }
  },
  "required": [
    "subject",
    "body",
    "toRecipients"
  ],
  "description": "Arguments for the outlook__create_draft tool."
}