Integrate ChatGPT and Claude with MCP
Connect AI assistants to NudgeForMe through OAuth-protected remote MCP.
MCP integration
NudgeForMe exposes a remote MCP server that allows compatible assistants to discover your mailboxes, inspect unanswered conversations, and prepare drafts. MCP uses OAuth 2.0 authorization code with PKCE, not developer API keys.
Endpoints
| Region | MCP endpoint |
|---|---|
| Global | https://app.nudgeforme.com/mcp |
| Europe | https://europe.nudgeforme.com/mcp |
Connect the URL that matches the account's data region. Your MCP client should discover the authorization server through the protected-resource metadata endpoint.
Connect to ChatGPT
- In ChatGPT, open its plugin/connectors configuration and add a supported remote MCP connector using your regional URL.
- Follow the NudgeForMe sign-in and consent screen; approve only the scopes needed.
- Ask: "List my connected NudgeForMe mailboxes."
- Next ask: "Show my outstanding follow-up opportunities. Do not change anything."
- Only grant write scopes when you want to watch or draft.
The exact connection screens depend on your ChatGPT account and interface version.
Connect to Claude or another MCP client
Configure a remote HTTP MCP server with the region-specific /mcp address. Use its OAuth sign-in flow. OAuth dynamic client registration is deployment-dependent; a client may need prior registration.
Exposed tools
| Tool | Description | Scope |
|---|---|---|
list_workspaces | Discover accessible workspaces | nudge.mailboxes.read |
list_mailboxes | Discover connected mailboxes | nudge.mailboxes.read |
find_conversations | Search existing sent conversations | nudge.conversations.read |
list_opportunities | List follow-up opportunities | nudge.conversations.read |
get_conversation_details | Read status and follow-up timestamps | nudge.conversations.read |
get_followup_status | Read watched thread status | nudge.conversations.read |
watch_conversation | Start watching an already-sent thread | nudge.conversations.write |
create_followup_draft | Prepare a draft for review | nudge.drafts.write |
pause_followup | Pause monitoring | nudge.followups.write |
Write tools require an 8–100-character unique requestId argument.
Example assistant prompts
- "Which follow-up opportunities in my Gmail mailbox are still waiting for a response? Just summarize."
- "Search my sent conversations for the proposal I sent to Acme. Don't create a draft."
- "Create a follow-up draft for the selected existing thread and leave it for me to review."
- "Pause monitoring for this specific conversation."
Nudge's remote MCP does not expose an email-sending tool. Only ask for changes when you intend them.
Troubleshooting
- 401 Unauthorized — authorize the remote MCP application via Nudge's OAuth flow.
- Missing tool — the client may not have obtained the needed OAuth scope.
- No mailboxes — check which account and region you authorized.
- Provider auth error — reconnect the affected Gmail/Outlook mailbox inside Nudge, not the MCP application.
- Client registration blocked — dynamic registration may be disabled; contact the Nudge operator for trusted OAuth client registration.
See Authentication and Use cases.