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.
MCP server that gives AI agents access to Telegram, Gmail, WhatsApp, Slack, and Discord. Pure Rust, 48 tools, single binary.
Étoiles
7
Outils
—
Disponibilité
—
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
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 across a platform
Telegram Tools (13)
Tool
Description
telegram_search_chat
Search within a specific chat
telegram_get_message
Get a single message with full metadata
telegram_get_chat_info
Chat details, member count, description
telegram_get_chat_members
List members with roles
telegram_send_media
Send photo/video/document
telegram_download_media
Download media to local file
telegram_forward_message
Forward between chats
telegram_edit_message
Edit your sent messages
telegram_delete_messages
Delete messages
telegram_pin_message
Pin a message
telegram_unpin_message
Unpin a message
telegram_mark_read
Mark messages as read
telegram_react
Add emoji reaction
Gmail Tools (13)
Tool
Description
gmail_send_email
Send with CC, BCC, attachments
gmail_create_draft
Create draft without sending
gmail_archive
Remove from inbox
gmail_trash
Move to trash
gmail_move_to
Move to any folder
gmail_list_labels
List all labels/folders
gmail_add_label
Add label to message
gmail_remove_label
Remove label from message
gmail_mark_read
Mark as read
gmail_mark_unread
Mark as unread
gmail_star
Star a message
gmail_unstar
Unstar a message
gmail_get_attachment
Download attachment to file
Slack Tools (9)
Tool
Description
slack_set_status
Set status message and emoji
slack_create_channel
Create a new channel
slack_invite_to_channel
Invite user to channel
slack_set_topic
Set channel topic
slack_add_reaction
React to a message
slack_remove_reaction
Remove reaction
slack_upload_file
Upload file to channels
slack_list_users
List workspace users
slack_get_user_info
Get user profile details
Discord Tools (6)
Tool
Description
discord_list_guilds
List servers the bot is in
discord_list_guild_channels
List channels in a server
discord_create_thread
Create a thread
discord_add_reaction
React to a message
discord_remove_reaction
Remove reaction
discord_pin_message
Pin a message
WhatsApp Tools (1)
Tool
Description
whatsapp_send_media
Send media file to a number
WhatsApp Business Cloud API is limited to sending only. Message history is not available through the API.
Format System
Every data-returning tool accepts an optional format parameter:
Format
Behavior
Use Case
compact (default)
One-liner per item, text truncated to 200 chars
Browsing, scanning, token-efficient
expanded
One-liner per item, full untruncated text
Reading full messages
full
Complete JSON with all fields
When you need exact field values
Examples:
Compact (default):
[Jan 15 10:30] John Doe (@john): Hey, I was thinking about the architecture for the new... (id:123456)
Expanded:
[Jan 15 10:30] John Doe (@john): Hey, I was thinking about the architecture for the new messaging service. We should probably use a hexagonal pattern with ports and adapters. What do you think? (id:123456)
Full:
{"id":"123456","platform":"telegram","channel_id":"-100123","sender":"John Doe","text":"Hey, I was thinking about...","timestamp":1705312200,...}
Architecture
Hexagonal (ports-and-adapters) with 9 workspace crates:
AgentError enum with suggestions and retryable flags
Core
core-domain
Shared entities (Message, Channel, Profile, etc.) and port traits (MessagingPort, TelegramExt, GmailExt, etc.)
Module
mod-messaging
AgentService (platform registry + routing) and Format engine
Infra
infra-tdlib
Telegram via TDLib FFI (4 C functions, dedicated receive thread)
Infra
infra-google
Gmail via IMAP + SMTP (connection pooling, MIME decoding)
Infra
infra-whatsapp
WhatsApp Business Cloud API via HTTP
Infra
infra-slack
Slack Web API via HTTP
Infra
infra-discord
Discord Bot API v10 via HTTP
App
app-mcp
Binary: CLI, MCP server (stdio JSON-RPC), tool definitions
MCP Protocol
Nexus uses newline-delimited JSON-RPC 2.0 on stdio (not Content-Length headers). stdout is exclusively for JSON-RPC responses. All logging goes to stderr via tracing.
Error Handling
Every error includes context to help the AI agent recover:
Enter your phone number, SMS code, and 2FA password if enabled.
The session is saved to ~/.nexus/tdlib/ — you won't need to authenticate again unless you revoke the session.
Note: Telegram requires TDLib (libtdjson.so) installed at /usr/local/lib. See the TDLib build guide for your platform. Set TDLIB_DIR env var if installed elsewhere.
Enable these Privileged Gateway Intents: Message Content Intent
Copy the bot token
Invite the bot to your server using OAuth2 URL Generator with bot scope and these permissions:
Read Messages/View Channels
Send Messages
Manage Messages (for pin/delete)
Add Reactions
Read Message History
Create Public Threads
Set environment variable:
export DISCORD_BOT_TOKEN=your_bot_token
CLI Reference
# Start the MCP server (default command)
nexus mcp
# Authenticate with Telegram (interactive, one-time)
nexus auth telegram
# Show help and environment variables
nexus help
Pas encore de liste d'outils. Les serveurs distants en obtiennent une après le premier contrôle d'état.
FAQ
Questions
Comment installer Nexus ?
Copiez sur cette page la configuration stdio pour Cursor, Claude Desktop, Claude Code ou VS Code. Elle utilise l'installation de l'éditeur, pas un proxy PlugMCP.
Nexus nécessite-t-il une clé API ?
Aucune variable d'environnement requise n'est indiquée sur cette fiche.
Quel transport Nexus utilise-t-il ?
Nexus s'exécute en local via stdio.
Quand Nexus a-t-il été vérifié pour la dernière fois ?
Dernière vérification : 2026-10-28. MCP server that gives AI agents access to Telegram, Gmail, WhatsApp, Slack, and Discord. Pure Rust, 48 tools, single binary.