Connect an AI agent to ReplyPocket
Connect an MCP-compatible AI agent to ReplyPocket with read-only access to your snippets. The MCP cannot create, edit or delete your snippets. Stored content is returned exactly as saved, while global variable values are returned separately so the agent can resolve placeholders in context.
1. Create a token
In the ReplyPocket app, open Settings, find AI agent (MCP), and select Generate new token.
The token and ready-to-paste configuration are shown once. Copy them immediately. Treat the token like a password. If you revoke it, it stops working; generating another token does not revoke it.
2. Add ReplyPocket to your client
Choose your client below. Use the token and server URL from Settings when you replace <YOUR_REPLYPOCKET_TOKEN>. Never put a real token in a prompt or commit it to a repository.
Replace <YOUR_REPLYPOCKET_TOKEN> entirely, including the < > signs, with the token from Settings. Keep the word Bearer and its space.
Codex and ChatGPT web have different configurations. Connecting ReplyPocket in Codex does not automatically connect it to ChatGPT web.
Codex
Add this reference configuration to ~/.codex/config.toml. The server name is arbitrary. The url is the ReplyPocket MCP endpoint. The Authorization header carries your personal token with the literal word Bearer, one space, then the token.
[mcp_servers.reply-pocket]
url = "https://reply-pocket-mcp-brujuleta.vercel.app/mcp"
[mcp_servers.reply-pocket.http_headers]
Authorization = "Bearer <YOUR_REPLYPOCKET_TOKEN>"Reference configuration; installation pending verification.
Cursor
Add ReplyPocket as a remote MCP server in Cursor. Save this configuration in ~/.cursor/mcp.json, or in .cursor/mcp.json for a project. Keep any other MCP servers in the file.
{
"mcpServers": {
"reply-pocket": {
"url": "https://reply-pocket-mcp-brujuleta.vercel.app/mcp",
"headers": {
"Authorization": "Bearer <YOUR_REPLYPOCKET_TOKEN>"
}
}
}
}Use the real token from Settings in place of <YOUR_REPLYPOCKET_TOKEN> and keep the word Bearer followed by one space.
Gemini CLI
In ~/.gemini/settings.json, add the ReplyPocket server under mcpServers. Gemini CLI uses httpUrl for Streamable HTTP; do not change it to url, because url selects the wrong SSE transport. Add the reply-pocket block inside mcpServers without replacing your existing servers.
{
"mcpServers": {
"reply-pocket": {
"httpUrl": "https://reply-pocket-mcp-brujuleta.vercel.app/mcp",
"headers": {
"Authorization": "Bearer <YOUR_REPLYPOCKET_TOKEN>"
}
}
}
}Antigravity
Antigravity 2.0: Settings (bottom left) → Customizations → Installed MCP Servers → Add MCP.
Antigravity IDE: the "…" menu of the agent panel → MCP Servers → Manage MCP Servers → View raw config, then edit the mcp_config.json file.
{
"mcpServers": {
"reply-pocket": {
"serverUrl": "https://reply-pocket-mcp-brujuleta.vercel.app/mcp",
"headers": {
"Authorization": "Bearer <YOUR_REPLYPOCKET_TOKEN>"
}
}
}
}Claude Code
Use Claude Code's HTTP transport command and replace <YOUR_REPLYPOCKET_TOKEN> with the token from Settings.
claude mcp add --transport http reply-pocket https://reply-pocket-mcp-brujuleta.vercel.app/mcp --header "Authorization: Bearer <YOUR_REPLYPOCKET_TOKEN>"ChatGPT web
Direct ReplyPocket connection to ChatGPT web is pending OAuth support in ReplyPocket.
The personal token you generate in ReplyPocket works with clients that let you configure an Authorization header. The documented ChatGPT web flow offers no field to paste that token.
Meanwhile, you can use ReplyPocket in Codex or the other token-configured clients in this guide. The Codex connection is configured separately.
Claude Desktop / web
Remote custom connectors use OAuth authorization flows. Direct Bearer JSON paste is not the documented path for Claude Desktop or web; use a token-compatible client above until ReplyPocket offers OAuth.
3. Test the connection
Use the prompt below after saving your client configuration.
Test the connection
Search for a snippet in ReplyPocket and, if you find one, retrieve its full content.If your library has snippets, the agent should use search_snippets and then get_snippet to retrieve the content of one of them. Some clients show these calls in the conversation details.
Expected behavior
The agent should preserve the snippet's language and wording, complete variables with the available values, and ask you for missing values instead of inventing them.
The MCP cannot create, edit or delete your snippets.
Search, reading, and variable resolution were verified in a Codex session on September 21, 2026. Fresh installation and connections from other clients were not covered by that test.
Keep your token private
Treat your MCP token like a password. It grants read-only access to your snippets, and the MCP cannot create, edit or delete your snippets. Never share the token, put it in a prompt, or commit it to a repository. You can revoke tokens at any time in Settings; generating a new token does not revoke previous tokens.
Troubleshooting
401 Unauthorized
Check that the token is complete and that the client is using the updated configuration. If you set Authorization manually, keep Bearer followed by one space. If the token was revoked, generate a new one and update the client.
Empty results
Try a broader search or ask the agent to browse the library without a filter. If there are still no results, check that the token belongs to the correct account and that the account has snippets.
Rate limit
Rate limit: all ReplyPocket MCP calls share about 60 requests per minute per token. Wait for the window to pass and try again.
Revoke or replace tokens
Generating a new token does not revoke previous ones; revoke unused tokens manually from Settings.
Still having trouble? Contact us from the Feedback option inside ReplyPocket. Tell us which client you are using, which step failed, and the error message you see. Do not include your token or screenshots that show it.