Stacey – Your Telegram AI Assistant (Powered by MCP, Gemini & Google Tools)

Description

> This n8n template builds Stacey, an AI assistant that runs inside Telegram. Stacey listens to your messages, understands what you want using AI, and intelligently routes commands to MCP-connected tools — like Gmail, Google Calendar, a blog writer, and more.
>
> For optimal performance, we recommend using OpenAI’s GPT-4o model. In this template, Google Gemini is used as a free alternative.

💡 Who is this for?

This workflow is designed for:

AI tool creators and automation builders
Entrepreneurs who want an intelligent Telegram assistant
Support and scheduling teams who use Google tools
Agencies that build & resell AI automations
Users looking to automate everyday actions like emails, scheduling, blog writing, and contact lookups

🧠 What this workflow does

Listens to Telegram messages (text and voice)
Transcribes audio using Whisper (optional)
Uses Stacey, an AI agent powered by Gemini (or GPT-4o if you upgrade), to:

Understand the user's intent
Choose the correct tool using MCP logic
Execute tasks using Gmail, Google Calendar, blog writer, and more
Responds to the user naturally with confirmations and outputs

⚙️ Prerequisites

Before using this workflow, make sure you have:

A self-hosted or cloud-based n8n instance
A Telegram Bot Token from @BotFather
Google OAuth2 credentials** for:

Gmail
Google Calendar
Optional: OpenAI or Whisper API key for voice transcription
Optional: Tavily API key for live web search
Gemini (Google AI) is preconfigured in the template but can be swapped

🚀 Step-by-Step Setup

✅ Step 1: Add Required Credentials in n8n

Go to Settings → Credentials and add:

Telegram API**: Your bot token from BotFather
Google OAuth2**:

Gmail: Scope https://www.googleapis.com/auth/gmail.modify
Calendar: Scope https://www.googleapis.com/auth/calendar
Gemini / Palm API**: Used for the language model
(Optional) OpenAI Whisper: For voice transcription
(Optional) Tavily: For real-time internet searches

✅ Step 2: Import the Workflow

Go to n8n
Click Workflows → Import from File
Upload ai_assistant.json
Connect your saved credentials to the correct nodes:

Telegram Trigger & Sender
Gmail, Calendar, Tavily, Gemini, Whisper


✅ Step 2.5: Import the Content Creator Sub-Workflow

The Content Creator is implemented as a modular sub-workflow and invoked through the Map Server as part of the MCP logic.

To set it up:

Go to Workflows → Import from File
Upload content_creator_tool.json (provided in your files)
Save it with a name like “Content Creator Tool”
🔗 Integration with MCP:

This tool is triggered via the MCP Map Server using an Execute Workflow node
The AI agent chooses this tool when the user request involves writing blog posts, emails, product descriptions, etc.
Make sure the tool ID or name in the Map Server matches what the AI agent uses in its logic
You can customize this sub-workflow to:

Adjust writing prompts (e.g., tone, format, target audience)
Add branching for different content types (e.g., blog vs. email)
Send outputs directly to Gmail, Google Docs, or Sheets
✅ Step 3: Set Up Your Telegram Bot

Talk to @BotFather
Use /newbot to create a bot and get your token
Paste this token into:

Telegram Trigger node (Telegram Trigger1)
Telegram Send Message node (Response1)
Make sure your bot’s privacy is set correctly (use /setprivacy)

✅ Step 4: Customize Your Assistant’s Personality

Open the “AI Agent” node
In the systemMessage field, you'll find a prompt that defines Stacey:

Her role is to delegate user requests to the right MCP tool
Includes examples, tone, rules, and logic
You can customize Stacey’s:

Name
Behavior
Supported tools

✅ Step 5: Define Your MCP Tools (if extending)

This template includes:

Send Email
Reply to Email
Get Emails
Label Emails
Create/Update/Delete Events
Content Creator
Search Web with Tavily
Calculator

To extend:

Add a new tool node
Link it to MCP Server Trigger
Reference it in the prompt in AI Agent node

✅ Step 6: Test the Workflow

Open Telegram and message your bot:

“Send an email to John about the new budget”
“Schedule a meeting Friday at 3 PM with Alex”
“Write a blog post about solar energy”
“What’s in my inbox?”
“Translate this message” (if extended with translation tools)

The bot will:

Interpret the intent
Ask for any missing data
Trigger the right tool
Send confirmation via Telegram

✨ Customization Ideas

✏️ Add Voice Transcription

Enable the Download File and Transcribe nodes
Requires OpenAI Whisper API key

🧠 Upgrade to GPT-4o

Replace the Gemini node with an OpenAI Chat node
Connect GPT-4o for improved reasoning and language understanding

🧩 Add More Tools

Notion, Slack, Salesforce, Hubspot, WhatsApp, and more can be added
Just route them via MCP and update the AI prompt

🧪 Troubleshooting

Telegram not responding?

Ensure correct bot token and webhook connection
Make sure the bot is not in privacy mode if needed

Gmail actions not working?

Double-check your OAuth scopes
Ensure Gmail API is enabled in your Google Cloud project

AI not responding or behaving poorly?

Consider upgrading to OpenAI GPT-4o for better reasoning
Revisit and refine your system prompt

🧾 Summary

Name: Stacey – AI Telegram Assistant
Built with: n8n + Gemini + Google + MCP Logic
Telegram acts as the front-end
Gemini or GPT-4o powers intelligence
MCP routes user intent to the right tool
Fully extensible and no-code friendly

🌟 Credits & License

Created by David Olusola
Free to use, modify, and resell with attribution.
If this helped you, please rate the template or follow me on the n8n Creator Page.