Claude Code

Fifteen works as an MCP (Model Context Protocol) server, which means Claude Code 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. Look for the MCP or Integrations section

3. Find the Claude Code connection option

4. Click "Connect to Claude Code" or similar button

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

That's it. When you open Claude Code, 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, depending on your install location:

claude mcp add \
    '/Applications/Fifteen.app/Contents/MacOS/fifteen mcp'

Notice the mcp at the end. That's important. You're not just pointing at the Fifteen binary - you're telling it to run in MCP server mode.

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

Verifying it works

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

If Fifteen is connected properly, Claude 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

1. Fifteen is actually running.

2. You're authenticated in Fifteen

3. You've connected at least one Telegram account

4. The path to the Fifteen binary is correct

Permissions

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

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

Multiple Claude Code instances

If you use Claude Code 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 Claude Code and your locally running Fifteen instance. No data goes through our servers.

FAQ

Can't find the MCP tools: Restart Claude Code 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'.