Documentation

MCP Server

Connect your AI assistant to Clevermore. Access your emails, tasks, contacts, and knowledge base through the Model Context Protocol.

Overview

The Clevermore MCP server gives your AI assistant direct access to your Outlook mailbox, extracted tasks, contact profiles, and knowledge wiki. It authenticates through your organization's Azure AD, so the same permissions and security policies that govern the Outlook add-in apply to MCP access.

How it works: When you connect, your browser opens an Azure AD sign-in page. After authentication, the MCP server receives a scoped token that can access your email and Clevermore data on your behalf. No passwords or API keys are stored by the MCP client.

Getting Started

Your Clevermore MCP server endpoint is:

clevermore.ai/api/mcp

Choose your AI client below for setup instructions.

Claude Code

Run this command in your terminal:

Terminal
claude mcp add clevermore \
  --transport http \
  clevermore.ai/api/mcp

Claude Code will open a browser window to authenticate with Azure AD on first use.

Claude Desktop

Add the following to your Claude Desktop configuration file:

claude_desktop_config.json
{
  "mcpServers": {
    "clevermore": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "clevermore.ai/api/mcp"
      ]
    }
  }
}

Requires mcp-remote (installed automatically via npx). A browser window will open for Azure AD sign-in on first connection.

Authentication

The MCP server uses OAuth 2.1 with PKCE, proxied through Azure AD. The flow is fully automatic:

  1. Your AI client discovers the MCP server's auth requirements automatically
  2. A browser window opens with your organization's Azure AD sign-in page
  3. After sign-in, the token is passed securely back to the MCP client
  4. The MCP server exchanges it for Graph API access using the On-Behalf-Of flow

Security note: The MCP client never sees your Azure AD password. Authentication happens entirely in the browser through Microsoft's sign-in page. Tokens are scoped to only the permissions needed and expire automatically.

Troubleshooting

Authentication fails or times out

Remove the MCP server and re-add it to trigger a fresh authentication flow. In Claude Code:

Terminal
claude mcp remove clevermore
claude mcp add clevermore --transport http clevermore.ai/api/mcp

Tools not appearing

Restart your AI client after adding the MCP server. Some clients require a restart to discover newly added MCP servers and their tools.

"Tenant not registered" error

Your organization needs to be set up with Clevermore before you can use the MCP server. Contact your administrator or reach out to us at clevermore.ai/contact.