OpenAI Codex

Fifteen works as an MCP (Model Context Protocol) server, which means OpenAI Codex can use it to search your Telegram messages, send messages, manage labels, and more.

There are two ways to set this up.

Through Settings

1. Open Fifteen and go to Settings

2. Scroll down to the OpenAI section

3. Look for the ChatGPT Integration section

4. Toggle "Integrate with ChatGPT Codex"

Fifteen will automatically configure itself as an MCP server in Codex's config. You might need to restart Codex for it to pick up the new server.

That's it. When you open Codex, you should see Fifteen's tools available.

Using the CLI

If you prefer doing things yourself or the Settings approach isn't working, you can add it manually:

codex mcp add fifteen -- /Applications/Fifteen.app/Contents/MacOS/fifteen mcp

Notice two things:

• The -- before the path (required by Codex)

• The mcp at the end - you're telling Fifteen to run in MCP server mode

If you installed Fifteen somewhere other than /Applications, adjust the path accordingly.

Verifying it works

Open Codex and type something like "search my telegram messages for discussions about databases" or "show me my recent telegram chats".

If Fifteen is connected properly, Codex will be able to:

• Search your messages with vector similarity

• List and filter your chats

• Send messages to chats and users

• Apply labels to messages

• Assign groups and chats to your organization

• And so much more

Troubleshooting

Make sure:

• Fifteen is actually running

• You're authenticated in Fifteen

• You've connected at least one Telegram account

• The path to the Fifteen binary is correct

• You included the -- separator in the command

Permissions

The first time Codex tries to use Fifteen's tools, you might see permission prompts in Fifteen. This is normal. You can configure which tools Codex can access in Fifteen's Settings → Permissions (⌘K permissions).

For example, you might want Codex to be able to search and read messages, but not send messages or delete things. Up to you.

Multiple machines

If you use Codex on multiple machines (and you're running Fifteen on each), you'll need to set up the MCP connection on each machine separately. The connection is local - it's not synced through your Fifteen account. It is also direct between Codex and your locally running Fifteen instance. No data goes through our servers.

FAQ

Can't find the MCP tools: Restart Codex after adding the connection. Sometimes it needs a full restart to pick up new servers.

Permission denied errors: Check the permissions in Fifteen's MCP settings. You might have restricted access to certain tools.

Wrong path error: Double-check you included mcp as a subcommand: -- /path/to/fifteen mcp not just -- /path/to/fifteen. Also make sure you included the -- separator.

Command not found: Make sure the Codex CLI is installed. You can check by running codex --version in your terminal.

What about ChatGPT Desktop?

ChatGPT Desktop integration is coming soon. For now, only Codex (ChatGPT's CLI) is supported.