<p>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.</p><p>There are two ways to set this up.</p><h2>Through Settings</h2><ol class="steps-list"><li><p>Open Fifteen and go to Settings</p></li><li><p>Look for the MCP or Integrations section</p></li><li><p>Find the Claude Code connection option</p></li><li><p>Click "Connect to Claude Code" or similar button</p><p></p></li></ol><p>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.</p><p>That's it. When you open Claude Code, you should see Fifteen's tools available.</p><h2>Using the CLI</h2><p>If you prefer doing things yourself or the Settings approach isn't working, you can add it manually, depending on your install location:</p><pre class="relative  language-bash" onmouseenter="initCodeBlockCopy()"><button class="absolute right-2 top-2 flex cursor-pointer items-center gap-1 rounded-lg bg-white px-1.5 py-1.5 text-xs font-medium text-gray-700 shadow-sm dark:bg-gray-800 dark:text-gray-200" onclick="copyCodeBlock(this)"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewbox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-copy-icon lucide-copy h-3.5 w-3.5 transition-transform duration-200 ease-in-out hover:scale-110"><rect width="14" height="14" x="8" y="8" rx="2" ry="2"></rect><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"></path></svg></button><code class="language-bash relative"><text>claude mcp add \
    </text><span class="hljs-string">'/Applications/Fifteen.app/Contents/MacOS/fifteen mcp'</span></code></pre><p>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.</p><p>If you installed Fifteen somewhere other than /Applications, adjust the path accordingly.</p><h2>Verifying it works</h2><p>Open Claude Code and type something like "search my telegram messages for discussions about databases" or "show me my recent telegram chats".</p><p>If Fifteen is connected properly, Claude will be able to:</p><ul class="accent-bullets"><li><p>Search your messages with vector similarity.</p></li><li><p>List and filter your chats.</p></li><li><p>Send messages to chats and users.</p></li><li><p>Apply labels to messages.</p></li><li><p>Assign groups and chats to your organization.</p></li><li><p>And so much more</p></li></ul><h2>Troubleshooting</h2><ol class="steps-list"><li><p>Fifteen is actually running.</p></li><li><p>You're authenticated in Fifteen</p></li><li><p>You've connected at least one Telegram account</p></li><li><p>The path to the Fifteen binary is correct</p><p></p></li></ol><h2>Permissions</h2><p>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).</p><p>For example, you might want Claude to be able to search and read messages, but not send messages or delete things. Up to you.</p><h2>Multiple Claude Code instances</h2><p>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.</p><h2>FAQ</h2><p><em>Can't find the MCP tools</em>: Restart Claude Code after adding the connection. Sometimes it needs a full restart to pick up new servers.</p><p><em>Permission denied errors</em>: Check the permissions in Fifteen's MCP settings. You might have restricted access to certain tools.</p><p><em>Wrong path error</em>: Double-check you included mcp as a subcommand: '/path/to/fifteen mcp' not just '/path/to/fifteen'.</p>

Integrations

Claude Code

Getting Started

Authentication & Early Access

Onboarding

Claude Desktop

OpenAI Codex

Using LLMs to Categorize Your Chats

Guides

Get Organized with Teams

Teams

Docs

Fifteen