Nexus

MCP server that gives AI agents access to messaging platforms. One binary, five platforms.

Telegram · Gmail · WhatsApp · Slack · Discord

Nexus implements the Model Context Protocol (MCP) over stdio, exposing 48 tools that let AI agents read, send, search, and manage messages across platforms through a unified interface.

Built in pure Rust. No MCP SDK dependencies — hand-rolled JSON-RPC 2.0. Single binary, ~4MB release.

Why Nexus?

AI agents need to communicate. They need to read your Telegram messages, send emails, search Slack history, and manage Discord channels — but each platform has its own API, auth flow, and data model.

Nexus unifies all of this behind MCP. Connect it to Claude Code, Claude Desktop, or any MCP client, and your agent gets instant access to your messaging world.

What agents can do with Nexus:

• Read and send messages across all platforms
• Search chat history (find that message from months ago)
• Manage emails (archive, label, star, draft, send with attachments)
• Forward, pin, react to, edit, and delete Telegram messages
• Create Slack channels, set topics, manage reactions
• List Discord guilds, create threads, pin messages
• Download media and attachments from any platform

Quick Start

1. Install

From source:

git clone https://github.com/santoshakil/nexus.git
cd nexus
cargo build --release
cp target/release/nexus ~/.local/bin/

Prerequisites:

• Rust 1.75+
• TDLib (libtdjson.so) — only needed for Telegram support. See TDLib build instructions.

2. Configure

Copy the example env file and fill in the platforms you want:

cp .env.example .env

You only need to configure the platforms you'll use. Nexus silently skips unconfigured platforms.

# Telegram (get from https://my.telegram.org)
TELEGRAM_API_ID=12345678
TELEGRAM_API_HASH=abcdef1234567890abcdef1234567890

# Gmail (generate App Password at https://myaccount.google.com/apppasswords)
GMAIL_ADDRESS=you@gmail.com
GMAIL_APP_PASSWORD=xxxx xxxx xxxx xxxx

# WhatsApp Business Cloud API (https://developers.facebook.com)
WHATSAPP_ACCESS_TOKEN=your_token
WHATSAPP_PHONE_NUMBER_ID=your_phone_id

# Slack (create app at https://api.slack.com/apps)
SLACK_BOT_TOKEN=xoxb-your-bot-token

# Discord (create app at https://discord.com/developers/applications)
DISCORD_BOT_TOKEN=your_bot_token

3. Authenticate Telegram (one-time)

Telegram requires an interactive login the first time:

nexus auth telegram

This prompts for your phone number, SMS code, and optional 2FA password. The session is saved to ~/.nexus/tdlib/ and reused automatically.

4. Connect to Claude Code

Add to your Claude Code MCP config (~/.claude/claude_code_config.json):

{
  "mcpServers": {
    "nexus": {
      "command": "nexus",
      "args": ["mcp"],
      "env": {
        "TELEGRAM_API_ID": "12345678",
        "TELEGRAM_API_HASH": "abcdef1234567890abcdef1234567890",
        "GMAIL_ADDRESS": "you@gmail.com",
        "GMAIL_APP_PASSWORD": "xxxx xxxx xxxx xxxx"
      }
    }
  }
}

Or for Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "nexus": {
      "command": "/path/to/nexus",
      "args": ["mcp"],
      "env": {
        "TELEGRAM_API_ID": "12345678",
        "TELEGRAM_API_HASH": "abcdef1234567890abcdef1234567890"
      }
    }
  }
}

Tools

Nexus exposes tools dynamically — only tools for configured platforms appear in tools/list.

Universal Tools (all platforms)

| Tool | Description | |------|-------------| | list_platforms | List connected platforms | | get_profile | Get authenticated user profile | | list_channels | List chats, folders, channels | | read_messages | Read messages with pagination | | send_message | Send a message (with optional reply) | | search | Search messages a

... View full README on GitHub