Connect your agent

Every client below connects to the same endpoint:

https://api.repliqo.app/mcp

All of them use OAuth — you'll be sent to Repliqo to sign in (if needed) and approve access on a consent screen. No API keys to copy.

Claude Code

claude mcp add --transport http repliqo https://api.repliqo.app/mcp

Then run /mcp inside Claude Code to complete the sign-in. Add --scope user to make the server available in all your projects.

Claude (claude.ai, Desktop, and mobile)

1. Go to Settings → Connectors → Add custom connector.
2. Paste https://api.repliqo.app/mcp and click Add.
3. Click Connect and approve access in the Repliqo window.

Custom connectors are available on all Claude plans; on Team and Enterprise an admin needs to add the connector for the organization.

Cursor

Click to install:

Add Repliqo to Cursor

Or add it to ~/.cursor/mcp.json yourself:

{
  "mcpServers": {
    "repliqo": {
      "url": "https://api.repliqo.app/mcp"
    }
  }
}

VS Code (GitHub Copilot)

code --add-mcp '{"name": "repliqo", "url": "https://api.repliqo.app/mcp"}'

Or click Add Repliqo to VS Code, or add the server to .vscode/mcp.json in a workspace:

{
  "servers": {
    "repliqo": {
      "url": "https://api.repliqo.app/mcp"
    }
  }
}

ChatGPT

1. Enable Settings → Apps & Connectors → Advanced → Developer mode (Plus/Pro/Business plan required).
2. Add a custom connector with the URL https://api.repliqo.app/mcp and complete the OAuth flow.

Repliqo also exposes the search and fetch tools ChatGPT's connector contract and Deep Research require, so research over your inbox works out of the box. Note that ChatGPT allows write tools only on Business/Enterprise/Edu plans — on Plus/Pro your agent can read and search but not triage.

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "repliqo": {
      "serverUrl": "https://api.repliqo.app/mcp"
    }
  }
}

Gemini CLI

Add to ~/.gemini/settings.json (note the key is httpUrl, not url):

{
  "mcpServers": {
    "repliqo": {
      "httpUrl": "https://api.repliqo.app/mcp"
    }
  }
}

Codex CLI

codex mcp add repliqo --url https://api.repliqo.app/mcp
codex mcp login repliqo

Anything else

Any client that supports remote MCP servers with streamable HTTP + OAuth works with the bare URL. For older clients that only speak stdio, bridge with mcp-remote:

{
  "mcpServers": {
    "repliqo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.repliqo.app/mcp"]
    }
  }
}

Troubleshooting

• 401 / "authentication required" — your token expired and the client didn't refresh it. Re-run the client's login step (e.g. /mcp → reconnect in Claude Code, codex mcp login repliqo).
• 429 / rate limited — the server caps request rates per token; agents should back off and retry.
• Write tools missing — the token was granted inbox:read only. Remove and re-add the connector, approving the write permission on the consent screen.
• Send tools missing — the token lacks inbox:send, which existing connections never gain automatically. Remove and re-add the connector, approving the send permission on the consent screen.
• Task, project, or document tools missing — the token predates those scopes (task:*, project:*, document:*); existing connections never gain them automatically. Remove and re-add the connector and approve them on the consent screen.
• Agent can't see a workspace or inbox — the connection was limited on the consent screen. Reconnect and pick "Everything" or add the missing workspace/inbox to the selection.