PigeonMCP
Home Dashboard

Setup Guide

Connect PigeonMCP to your AI tool in a few minutes. You'll need your MCP endpoint URL:

https://pigeonmcp.email/mcp

Before you start

  1. Create a PigeonMCP account (free)
  2. Connect at least one email or calendar from the dashboard
  3. Copy your MCP endpoint URL above

Claude

Works with Claude.ai, Claude Desktop, and Claude Code.

Claude.ai & Claude Desktop

  1. Open Customize (bottom-left) and go to Connectors
  2. Click + and choose Add custom connector
  3. Paste the MCP endpoint URL: https://pigeonmcp.email/mcp
  4. Click Add and complete the OAuth sign-in when prompted
  5. To use in a conversation, click + in the chat input, then Connectors, and toggle PigeonMCP on
Tip: After connecting, try asking Claude: "What email accounts do I have connected?" to verify everything is working. Custom connectors work across Claude.ai, Claude Desktop, and the mobile app.

Claude Code (CLI)

  1. Run: claude mcp add --transport http pigeonmcp https://pigeonmcp.email/mcp
  2. Complete the OAuth flow in your browser when prompted

ChatGPT

ChatGPT supports MCP connectors for Business, Enterprise, and Edu plans. Requires Developer Mode enabled by a workspace admin.

  1. Have a workspace admin enable Developer Mode in Workspace Settings → Permissions & Roles
  2. Open Settings → Apps & Connectors
  3. Click Add new connector
  4. Enter a name (e.g. "PigeonMCP") and paste the URL: https://pigeonmcp.email/mcp
  5. Set authentication to OAuth and click Create
  6. Complete the OAuth sign-in flow to authorize access
  7. In a new chat, select PigeonMCP from the apps menu to use it
Note: MCP connectors in ChatGPT require a Business, Enterprise, or Edu plan with Developer Mode enabled. Individual Plus plans do not currently support custom MCP connectors.

Other MCP Clients

PigeonMCP works with any client that supports the Model Context Protocol over HTTP with OAuth 2.1.

  1. Add a new MCP server with the URL: https://pigeonmcp.email/mcp
  2. Transport type: HTTP (streamable HTTP, not SSE or stdio)
  3. Auth: OAuth 2.1 — the server handles discovery automatically via /.well-known/oauth-authorization-server
  4. Complete the OAuth sign-in in your browser

Verify It Works

Once connected, try these prompts to make sure everything is working:

  1. "What email accounts do I have connected?" — should list your connected accounts
  2. "Check my inbox" — should show recent messages
  3. "What's on my calendar this week?" — should list upcoming events (if calendar connected)
  4. "Draft an email to hello@example.com about our meeting" — should create a draft you can review