convez.ai
MCP ServerIntegração & APIsAvançado
gkfs-it

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 GitHub
InicialPluginScore · de 0 a 100

MCP 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-bot

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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-бот, маршрутизація намірів через Ollama
  • mcp_server/ — MCP stdio-сервер з інструментами calendar_query, calendar_create, email_query
  • calendar_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_IDTelegram 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_URLURL 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-конфігурацію та підготувати проект до публікації — від першої ідеї до робочого бота.


Бот підтримує лише одного користувача (особистий інструмент). Мультитенантність не передбачена.

Ver o original no GitHub

Bom para

Relacionados