Ollama MCP Calendar & Email Bot
gkfs-it/ollama-mail-cal-bot
Calendário e email corporativo via IA local com Ollama e MCP
Ver no GitHubMCP server que integra calendário (CalDAV) e email (IMAP) com Ollama via tool calling, permitindo gerenciar eventos e consultar mensagens importantes através de linguagem natural. Funciona com servidores Zimbra, Carbonio e similares, mantendo tudo na sua infraestrutura privada.
Instalação
npx convez-ai gkfs-it/ollama-mail-cal-bot1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Consultar eventos do calendário em linguagem natural (ex: 'Quais reuniões tenho hoje?')
- Criar compromissos com nós de voz do Telegram ('Agendar meeting amanhã às 10h')
- Buscar emails marcados como importantes em períodos específicos
Veredito

Solução robusta para automação de produtividade corporativa com IA local. Exige configuração técnica de CalDAV/IMAP e Ollama, mas oferece privacidade total — ideal para equipes que precisam manter dados sensíveis on-premises.
README
A tradução para o português deste README ainda está na fila.
Ollama MCP Calendar & Email Telegram Bot
Персональний Telegram-бот для роботи з корпоративним календарем і поштою через природню мову. Запит у Telegram → Ollama розпізнає намір → CalDAV / IMAP → відповідь у чаті. Все залишається всередині вашої інфраструктури.
Можливості
- Календар — запитати події на день або діапазон дат, створити нову подію з нагадуванням
- Пошта — знайти важливі листи (позначені прапорцем) за вказаний період
- Природна мова — «Які події сьогодні?», «Важливі листи за тиждень», «Створи зустріч завтра о 10:00»
- Приватність — жодних зовнішніх LLM API; Ollama та пошта працюють на ваших серверах
Архітектура
Telegram → aiogram bot → Ollama (tool calling)
↓
MCP Server (stdio)
↙ ↘
CalDAV client IMAP client
↓ ↓
CalDAV-сервер IMAP-сервер
bot/— aiogram-бот, маршрутизація намірів через Ollamamcp_server/— MCP stdio-сервер з інструментамиcalendar_query,calendar_create,email_querycalendar_integration/— CalDAV-клієнт (читання та створення подій)email_integration/— IMAP-клієнт (пошук листів з міткою «Важливе»)
Вимоги
- Docker та Docker Compose
- Ollama з моделлю, що підтримує tool calling (рекомендовано
gemma3:12bабо новіша) - Поштовий сервер з підтримкою CalDAV та IMAP (Zimbra, Carbonio, Nextcloud та ін.)
- Telegram-бот (токен від @BotFather)
Розгортання
1. Клонувати репозиторій
git clone https://github.com/your-username/ollama-mcp-calendar-email-telegram-bot.git
cd ollama-mcp-calendar-email-telegram-bot
2. Створити файл .env
cp .env.example .env
Заповнити значення:
# Telegram
TELEGRAM_BOT_TOKEN= # токен від @BotFather
ALLOWED_USER_ID= # ваш Telegram user_id (отримати через @userinfobot)
# Zimbra / CalDAV
ZIMBRA_USER= # логін (зазвичай email)
ZIMBRA_PASS= # пароль
CALDAV_HOST= # хост CalDAV-сервера, наприклад mail.example.com
# IMAP
IMAP_HOST= # хост IMAP-сервера
IMAP_PORT=993
IMAP_USER= # логін IMAP (зазвичай збігається з ZIMBRA_USER)
IMAP_PASS= # пароль IMAP (зазвичай збігається з ZIMBRA_PASS)
# Ollama
OLLAMA_BASE_URL=http://your-ollama-host:11434
OLLAMA_MODEL=gemma3:12b # модель з підтримкою tool calling
3. Переконатися, що Ollama запущена і модель завантажена
curl http://your-ollama-host:11434/api/tags
# якщо потрібна модель відсутня:
ollama pull gemma3:12b
4. Запустити
docker compose up -d
5. Перевірити роботу
Відкрийте бота в Telegram і надішліть /start. Потім спробуйте:
Які події сьогодні?
Важливі листи за цей тиждень
Створи подію завтра о 10:00 Нарада з нагадуванням за 30 хвилин
Зупинити
docker compose down
Структура .env
| Змінна | Опис | Обов'язкова |
|---|---|---|
TELEGRAM_BOT_TOKEN | Токен бота від @BotFather | ✓ |
ALLOWED_USER_ID | Telegram ID єдиного авторизованого користувача | ✓ |
ZIMBRA_USER | Логін для CalDAV | ✓ |
ZIMBRA_PASS | Пароль для CalDAV | ✓ |
CALDAV_HOST | Хост CalDAV-сервера | ✓ |
IMAP_HOST | Хост IMAP-сервера | ✓ |
IMAP_PORT | Порт IMAP (зазвичай 993) | |
IMAP_USER | Логін для IMAP | ✓ |
IMAP_PASS | Пароль для IMAP | ✓ |
OLLAMA_BASE_URL | URL Ollama API | ✓ |
OLLAMA_MODEL | Назва моделі з тегом | ✓ |
Розробка
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest
Примітка
Цей проект створений за допомогою Claude Code — AI-асистента для розробки від Anthropic.
Щира вдяка команді Anthropic за цей неймовірний інструмент. Claude Code допоміг спроектувати архітектуру, написати весь код, налагодити Docker-конфігурацію та підготувати проект до публікації — від першої ідеї до робочого бота.
Бот підтримує лише одного користувача (особистий інструмент). Мультитенантність не передбачена.