Esper MCP Server

Esper MCP Server is a Model Context Protocol (MCP) server that interfaces with Esper APIs.

Overview

Purpose: This MCP server allows AI agents and other tools to interact with Esper platform functionalities through a standardized protocol.

Authentication

The Esper MCP Server supports multiple authentication methods:

Environment Variables

You can provide credentials via environment variables:

• ESPER_TOKEN: Your Esper API token
• ESPER_ENTERPRISE_ID: Your Esper enterprise ID
• ESPER_TENANT: Your Esper tenant name

Authentication

You can authenticate via browser using the CLI (Please note you need to be logged in to the Esper tenant to authenticate):

# Authenticate with a specific tenant
./esper-mcp-server auth login --tenant esper

# Authenticate with default (localhost for development)
./esper-mcp-server auth login

Authentication Commands

• ./esper-mcp-server auth login: Authenticate via browser
• ./esper-mcp-server auth logout: Clear stored credentials
• ./esper-mcp-server auth status: Check authentication status

Configure Claude Desktop or any IDE that supports MCP Servers

{
  "mcpServers": {
    "esper": {
      "command": "npx",
      "args": [
        "-y",
        "@esperio/mcp-server@latest",
        "stdio"
      ]
    }
  }
}

Option B: With Environment Variables

{
  "mcpServers": {
    "esper": {
      "command": "npx",
      "args": [
        "-y",
        "@esperio/mcp-server@latest",
        "stdio"
      ],
      "env": {
        "ESPER_TOKEN": "your_esper_token_here",
        "ESPER_ENTERPRISE_ID": "your_enterprise_id_here",
        "ESPER_TENANT": "your_tenant_name",
        "LOG_LEVEL": "error",
        "LOG_DIR": "/tmp/esper-logs"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add esper-mcp npx @esperio/mcp-server@latest stdio