Microsoft Exchange Exchange Online Admin API

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Exchange Exchange Online Admin API
  description: REST-based administrative API that enables a focused set of Exchange cmdlets and parameters as POST-only endpoints.
    Provides access to key tasks previously available through Exchange Web Services (EWS), including organization configuration,
    accepted domains, mailbox properties, mailbox folder permissions, and distribution group membership. Built as a complementary
    REST-first surface for specific administrative tasks caused by the EWS deprecation planned for October 2026.
  tags:
  - Microsoft
  - Exchange
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: microsoft-exchange
    baseUri: https://outlook.office365.com/adminapi/v2.0
    description: Microsoft Exchange Exchange Online Admin API HTTP API.
    authentication:
      type: bearer
      token: '{{MICROSOFT_EXCHANGE_TOKEN}}'
    resources:
    - name: organizationconfig
      path: /OrganizationConfig
      operations:
      - name: getorganizationconfig
        method: POST
        description: Microsoft Exchange Get organization configuration
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: accepteddomain
      path: /AcceptedDomain
      operations:
      - name: getaccepteddomains
        method: POST
        description: Microsoft Exchange Get accepted domains
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: mailbox
      path: /Mailbox
      operations:
      - name: managemailbox
        method: POST
        description: Microsoft Exchange Manage mailbox
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: mailboxfolderpermission
      path: /MailboxFolderPermission
      operations:
      - name: managemailboxfolderpermission
        method: POST
        description: Microsoft Exchange Manage mailbox folder permissions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: distributiongroupmember
      path: /DistributionGroupMember
      operations:
      - name: getdistributiongroupmembers
        method: POST
        description: Microsoft Exchange Get distribution group members
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: dynamicdistributiongroupmember
      path: /DynamicDistributionGroupMember
      operations:
      - name: getdynamicdistributiongroupmembers
        method: POST
        description: Microsoft Exchange Get dynamic distribution group members
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: microsoft-exchange-rest
    description: REST adapter for Microsoft Exchange Exchange Online Admin API.
    resources:
    - path: /OrganizationConfig
      name: getorganizationconfig
      operations:
      - method: POST
        name: getorganizationconfig
        description: Microsoft Exchange Get organization configuration
        call: microsoft-exchange.getorganizationconfig
        outputParameters:
        - type: object
          mapping: $.
    - path: /AcceptedDomain
      name: getaccepteddomains
      operations:
      - method: POST
        name: getaccepteddomains
        description: Microsoft Exchange Get accepted domains
        call: microsoft-exchange.getaccepteddomains
        outputParameters:
        - type: object
          mapping: $.
    - path: /Mailbox
      name: managemailbox
      operations:
      - method: POST
        name: managemailbox
        description: Microsoft Exchange Manage mailbox
        call: microsoft-exchange.managemailbox
        outputParameters:
        - type: object
          mapping: $.
    - path: /MailboxFolderPermission
      name: managemailboxfolderpermission
      operations:
      - method: POST
        name: managemailboxfolderpermission
        description: Microsoft Exchange Manage mailbox folder permissions
        call: microsoft-exchange.managemailboxfolderpermission
        outputParameters:
        - type: object
          mapping: $.
    - path: /DistributionGroupMember
      name: getdistributiongroupmembers
      operations:
      - method: POST
        name: getdistributiongroupmembers
        description: Microsoft Exchange Get distribution group members
        call: microsoft-exchange.getdistributiongroupmembers
        outputParameters:
        - type: object
          mapping: $.
    - path: /DynamicDistributionGroupMember
      name: getdynamicdistributiongroupmembers
      operations:
      - method: POST
        name: getdynamicdistributiongroupmembers
        description: Microsoft Exchange Get dynamic distribution group members
        call: microsoft-exchange.getdynamicdistributiongroupmembers
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: microsoft-exchange-mcp
    transport: http
    description: MCP adapter for Microsoft Exchange Exchange Online Admin API for AI agent use.
    tools:
    - name: getorganizationconfig
      description: Microsoft Exchange Get organization configuration
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-exchange.getorganizationconfig
      outputParameters:
      - type: object
        mapping: $.
    - name: getaccepteddomains
      description: Microsoft Exchange Get accepted domains
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-exchange.getaccepteddomains
      outputParameters:
      - type: object
        mapping: $.
    - name: managemailbox
      description: Microsoft Exchange Manage mailbox
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-exchange.managemailbox
      outputParameters:
      - type: object
        mapping: $.
    - name: managemailboxfolderpermission
      description: Microsoft Exchange Manage mailbox folder permissions
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-exchange.managemailboxfolderpermission
      outputParameters:
      - type: object
        mapping: $.
    - name: getdistributiongroupmembers
      description: Microsoft Exchange Get distribution group members
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-exchange.getdistributiongroupmembers
      outputParameters:
      - type: object
        mapping: $.
    - name: getdynamicdistributiongroupmembers
      description: Microsoft Exchange Get dynamic distribution group members
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-exchange.getdynamicdistributiongroupmembers
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    MICROSOFT_EXCHANGE_TOKEN: MICROSOFT_EXCHANGE_TOKEN