Prerequisites Before you begin, create an account and get your API Key.

​
Getting started

Connect to Outlook to read, send, organize emails, and automate email workflows through AI agents.
1

Install the SDKs (optional)

pip install klavis
2

Create a server instance

from klavis import Klavis
from klavis.types import McpServerName

klavis_client = Klavis(api_key="YOUR_API_KEY")

# Create an Outlook MCP server instance
outlook_server = klavis_client.mcp_server.create_server_instance(
    server_name=McpServerName.OUTLOOK,
    user_id="user123"
)
Response Information: The API returns:
  • serverUrl: The URL for connecting your MCP client to Outlook
  • instanceId: Unique identifier for your server instance
  • oauthUrl: OAuth authorization URL for Outlook authentication
3

Authenticate

import webbrowser

# Open OAuth authorization page
webbrowser.open(outlook_server.oauth_url)
🎉 Your Outlook MCP Server is ready! Once authentication is complete, you can use your MCP server URL with any MCP-compatible client.

​
Available Tools

Tool NameDescription
outlookMail_create_mail_folderCreate a new mail folder
outlookMail_list_foldersList all mail folders
outlookMail_get_mail_folder_detailsGet details of a mail folder
outlookMail_update_folder_display_nameRename a mail folder
outlookMail_delete_folderDelete a mail folder
outlookMail_read_messageRead the content of an email
outlookMail_send_draftSend an existing draft email
outlookMail_create_draftCreate a new draft email
outlookMail_create_reply_draftCreate a reply to an email
outlookMail_create_reply_all_draftCreate a reply-all draft
outlookMail_create_forward_draftCreate a forward draft
outlookMail_update_draftUpdate an existing draft
outlookMail_delete_draftDelete a draft email
outlookMail_list_messagesList messages from the inbox
outlookMail_list_messages_from_folderList messages from a specific folder
outlookMail_move_messageMove message to a different folder
For more details about tool input schema, use the get_tools API.

​
Next Steps

White-label Authentication

Customize OAuth flows with your own branding

AI Platform Integrations

Integrate Klavis MCP Servers with leading AI platforms

Integrations

Explore available MCP servers

API Reference

REST endpoints and schemas