Claude Desktop

Fifteen works as an MCP (Model Context Protocol) server for Claude Desktop, giving Claude access to search your Telegram messages, send messages, manage contacts, and more. Two ways to set it up.

Through Settings

1. Open Fifteen and go to Settings (⌘K settings)

2. Look for the MCP or Integrations section

3. Find the Claude Desktop connection option

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

Fifteen will automatically add itself to Claude Desktop's MCP configuration file. You'll need to restart Claude Desktop for it to pick up the new server. When you open Claude Desktop, Fifteen's tools should be available.

Manually editing the config

If you want to do it yourself or the automatic setup isn't working, you can edit Claude Desktop's config file directly.

To find the configuration file, open Claude Desktop, go to Settings -> Developer and press edit config.

Open it in a text editor and add Fifteen to the mcpServers section:

{ 
    "mcpServers": { 
        "fifteen": { 
            "command": "/Applications/Fifteen.app/Contents/MacOS/fifteen", 
            "args": ["mcp"] 
         } 
     } 
}

If you already have other MCP servers configured, just add the fifteen entry to the existing list. Don't forget commas between entries.

If Fifteen is installed somewhere other than /Applications, update the path in command.

Save the file and restart Claude Desktop completely (quit and reopen, not just close the window).

Verifying the Integration

Open Claude Desktop and ask something like "search my telegram messages for discussions about the product launch" or "show me my recent telegram chats".

If it's working, Claude will be able to:

• Search messages with vector similarity

• List and filter chats

• Send messages to Telegram

• Manage audiences and broadcasts

• Apply labels to messages

• Add contacts to audiences

• And everything else Fifteen's MCP tools support

  If nothing happens, check:

1. Fifteen is actually running

2. You're signed in to Fifteen

3. You've connected at least one Telegram account

4. The path in the config is correct

5. You restarted Claude Desktop after editing the config

Permissions

First time Claude Desktop tries to use Fifteen's tools, you'll probably see permission prompts in Fifteen. This is expected. You control which tools Claude can access in Fifteen's Settings → MCP → Permissions.

Maybe you want Claude to search and read messages but not send them. Maybe you want full access. Your call.

Multiple machines

If you use Claude Desktop on multiple computers and run Fifteen on each, you need to configure the MCP connection on each machine separately. It's a local connection, not synced through your account.

FAQ

Tools don't appear: Fully quit Claude Desktop (⌘Q) and reopen it. Sometimes it needs a complete restart to load new MCP servers.

"Command not found" or similar errors: Check the path in your config file. Make sure you're pointing to the actual binary inside the .app bundle.

Permission errors: Open Fifteen's MCP settings and check what permissions you've granted. You might have tools disabled.

Config file doesn't exist: Create it. Make a new file at ~/Library/Application Support/Claude/claudedesktopconfig.json with the JSON structure above.

JSON syntax errors: Use a JSON validator if you're editing manually. Missing commas or brackets will break the whole config. Claude Desktop won't start if the config is malformed.