Getting Started with Outlook Assistant

What you’ll need

• Node.js 18+ installed on your machine
• A Microsoft account (personal or work/school) with Outlook access
• Claude Desktop or another MCP-compatible client

Install

Run the MCP server directly with npx — no global install required:

npx @littlebearapps/outlook-assistant

On first run, it will guide you through Microsoft OAuth authentication in your browser.

Configure your MCP client

Claude Desktop

Add this to your Claude Desktop MCP config (claude_desktop_config.json):

{
  "mcpServers": {
    "outlook-assistant": {
      "command": "npx",
      "args": ["@littlebearapps/outlook-assistant"]
    }
  }
}

Claude Code

For Claude Code, add to your project’s .mcp.json:

{
  "mcpServers": {
    "outlook-assistant": {
      "command": "npx",
      "args": ["@littlebearapps/outlook-assistant"]
    }
  }
}

Authenticate with Microsoft

1. When the server starts, it opens a browser window for Microsoft login
2. Sign in with your Microsoft account
3. Grant the requested permissions (read/send email, calendar, contacts)
4. The token is stored locally — you won’t need to sign in again until it expires

Try your first command

Once connected, ask Claude something like:

“Show me my unread emails from today”

Or:

“What meetings do I have this week?”

Outlook Assistant gives Claude access to 20 tools across email, calendar, contacts, folders, rules, settings, and shared mailboxes.

What’s next

• Check the build page for the full feature list
• Found a bug? Report it on GitHub
• Have a question? Ask in Discussions