IntegrationsChatGPT & Claude MCP

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

RegionMCP endpoint
Globalhttps://app.nudgeforme.com/mcp
Europehttps://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

  1. In ChatGPT, open its plugin/connectors configuration and add a supported remote MCP connector using your regional URL.
  2. Follow the NudgeForMe sign-in and consent screen; approve only the scopes needed.
  3. Ask: "List my connected NudgeForMe mailboxes."
  4. Next ask: "Show my outstanding follow-up opportunities. Do not change anything."
  5. 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

ToolDescriptionScope
list_workspacesDiscover accessible workspacesnudge.mailboxes.read
list_mailboxesDiscover connected mailboxesnudge.mailboxes.read
find_conversationsSearch existing sent conversationsnudge.conversations.read
list_opportunitiesList follow-up opportunitiesnudge.conversations.read
get_conversation_detailsRead status and follow-up timestampsnudge.conversations.read
get_followup_statusRead watched thread statusnudge.conversations.read
watch_conversationStart watching an already-sent threadnudge.conversations.write
create_followup_draftPrepare a draft for reviewnudge.drafts.write
pause_followupPause monitoringnudge.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.