MCP Server Overview
PortEden MCP is a connector that lets AI assistants — Claude, ChatGPT, Cursor, or any MCP-compatible client — read and act on the services you've connected inside PortEden. The AI never sees your provider passwords. Every action goes through the PortEden API, which enforces your permissions, quotas, and provider limits.
Base URL
https://mcp.porteden.comAuthentication
OAuth or Bearer pe_mcp_...Token Management
Manage permissions and revoke tokens at my.porteden.com
Note
The Six Connections
PortEden MCP is split into six focused endpoints. Each one is a separate MCP connection in your client config. Adding only the connections you need keeps the AI's tool list small and its answers sharper.
| Connection | Endpoint | Tools | What It Covers |
|---|---|---|---|
| 8 | Search, read, reply, forward, send, label, delete across Gmail and M365 | ||
| Calendar | /calendar | 9 | List, search, create, update, delete events; check availability; RSVP |
| Drive | /drive | 10 | Search, upload, rename, move, share, delete files and folders |
| Google Docs | /google-docs | 5 | Search, read, and edit Google Docs |
| Google Sheets | /google-sheets | 7 | Read cells, write ranges, append rows to Google Sheets |
| Tasks | /tasks | 11 | Boards, items, comments across Monday, Linear, Asana, Jira, and Notion |
Why the split?
/email; a power user can add all six. See each connection's page for the full tool catalogue.Connecting from Each Client
Claude (OAuth, recommended)
Go to Customize > Connectors > + > Add custom connector on claude.ai and paste the endpoint URL. Claude handles the OAuth sign-in automatically. Works across claude.ai, Claude Desktop, Cowork, and mobile.
https://mcp.porteden.com/email Claude.ai guide → · Desktop config guide → · Cowork guide →
ChatGPT (Connectors, OAuth)
Go to Settings > Connectors > Add connector in ChatGPT and paste the endpoint URL. Each connection is a separate connector. Token refresh is automatic.
Cursor and Other MCP Clients (Manual Token)
Generate a token at my.porteden.com (starts with pe_mcp_) and paste it as an Authorization header:
{ "mcpServers": { "porteden-email": { "url": "https://mcp.porteden.com/email", "headers": { "Authorization": "Bearer pe_mcp_YOUR_TOKEN_HERE" } } } } Ready-Made Prompts
Four prompts are registered on any connection that has all of its required tools. Users see them as slash-commands or suggested actions inside their MCP client.
| Prompt | What It Does | Required Connections |
|---|---|---|
| daily-briefing | Summarize today's calendar events and unread emails from the last 24 hours. | Email + Calendar |
| prepare-for-meeting | Pull event details, recent emails with attendees (14-day window), and shared files for an upcoming meeting. | Email + Calendar + Drive |
| project-status | Summarize a task board's items grouped by status, flagging overdue and unassigned items. | Tasks |
| weekly-review | Review the past 7 days: meetings attended, key email threads, tasks completed, open action items. | Email + Calendar + Tasks |
Note
prepare-for-meeting shows up on /email, /calendar, and /drive but is absent from /tasks.Permissions
Every action is made with the user's PortEden access token. The token's granted permissions are the ceiling — the AI cannot exceed them, even if asked.
- Permissions are managed at my.porteden.com. Users can narrow a token to read-only, limit it to a single provider, or revoke it at any time.
- Each tool is labelled Read, Create, Update, Delete, or Send. A token without the matching scope gets a "Permission denied" response.
- No data is stored by PortEden MCP itself. Every call is forwarded to the PortEden API, which enforces the token and logs the action.
See Permissions and Access Rules for full details.
Quotas & Limits
Monthly API Quota
PortEden enforces a monthly request quota per access token. The current count is appended to every tool response:
[API quota: 450/500 used, 50 remaining] Per-Tool Limits
| Tool | Limit |
|---|---|
| email_search | Up to 50 results per page (default 20) |
| calendar_search_events | Up to 1,000 results (default 50) |
| drive_search, google_docs_search, google_sheets_search | Up to 100 results per page (default 25) |
| drive_upload | ~24 MB of file content |
| google_docs_edit | Up to 100 operations per call; max 5 MB request body |
| google_sheets_read | Range string max 200 characters |
| google_sheets_write | Up to 10,000 cells per call |
| google_sheets_append | Up to 5,000 rows per call |
| tasks_search_items | Up to 200 results per call; query max 500 characters |
Burst Protection
The MCP server returns 503 Service Unavailable with Retry-After: 1 if at capacity. Clients automatically retry — users normally don't see this.
Troubleshooting
| Condition | What to Do |
|---|---|
| Authentication failed | Re-connect PortEden from the client. Claude and ChatGPT start sign-in automatically; manual-token clients need a fresh token from my.porteden.com. |
| Permission denied | Open my.porteden.com and grant the missing permission, then retry. |
| Not found | The referenced item doesn't exist or isn't accessible with the connected accounts. |
| Invalid request | The tool's response explains what's wrong. Retry with corrected input. |
| Monthly quota exceeded | Wait for the next billing period or upgrade at my.porteden.com. |
| Upstream provider error | The underlying provider had a temporary failure. Retry in a minute. |
| Network / unreachable | PortEden's API was not reachable. Usually transient. |
Privacy & Security
- No data storage. PortEden MCP is a pass-through. No database, no cache, no tokens on disk.
- Tokens are never logged. Access tokens move from client to PortEden API in the Authorization header and nowhere else.
- HTTPS-only in production.
- Revoke any time. Takes effect immediately on the next request.
- Minimal attack surface. A compromised MCP server has no user data and no way to mint new tokens.
FAQ
Do I need all six connections?
No. Add only the ones you want. The AI only sees the tools for the connections you enable.
Can I mix providers — for example Gmail and Outlook calendar?
Yes. Each domain spans all providers connected to your PortEden account.
Does the AI see my passwords?
No. It only sees the opaque pe_mcp_... access token, which has no provider credentials inside it.
Can the AI send email on my behalf?
Only if the token has the email_send permission. You control this at my.porteden.com.
How do I revoke access?
Go to my.porteden.com, find the token under MCP access, and revoke. Takes effect on the next tool call.
Why are Google Docs and Sheets separate from Drive?
To keep the tool list focused. A user who only wants spreadsheets can add /google-sheets and avoid 10 generic file-management tools.
Which providers are supported?
Gmail, Microsoft 365 (email + calendar), Google Drive, Google Docs, Google Sheets, Monday.com, Linear, Asana, Jira Cloud, and Notion.