Kommunicator™ - CLI & MCP Server for Teams and Email

Features

Everything you need to communicate

Powerful features for seamless messaging in your Office 365 environment

📧

Send Emails

Send emails via Teams webhook with support for email addresses and human-friendly aliases.

💬

Teams Messages

Send messages to users, conversations, and channels with automatic target detection.

👥

Human Aliases

Use friendly names instead of email addresses. Automatic alias generation from email parts.

🎯

Auto-Detection

Automatically detects target type - user, conversation, or channel - based on recipient.

🚀

MCP Server

Built on FastMCP framework for seamless integration with MCP-compatible clients like Claude.

📊

Mass Sending

Send messages to multiple recipients at once with detailed success/failure reporting.

🎨

Adaptive Cards

Support for rich Adaptive Cards with auto-detection from JSON content.

🔧

No Admin Rights

Works with standard Office 365 access via Power Automate webhooks.

Usage

Simple and intuitive commands

Get started in seconds with easy-to-remember commands

Send an email

./kommunicator-cli.py send-email \
  --to john \
  --subject "Meeting Reminder" \
  --body "Don't forget our meeting at 2pm!"

Send a Teams message

./kommunicator-cli.py send-teams \
  --to "Dev Team" \
  --message "Deployment complete! 🚀"

Mass sending

./kommunicator-cli.py send-teams \
  --to recipients.conf \
  --message "Important announcement for everyone"

Start the MCP server

uv run kommunicator-mcp.py

Development mode with Inspector

uv run mcp dev kommunicator-mcp.py

Claude Desktop configuration

{
  "mcpServers": {
    "mcp-kommunicator": {
      "command": "uv",
      "args": ["--directory", "/path/to/kommunicator", "run", "kommunicator-mcp.py"],
      "env": { "TEAMS_WEBHOOK_KOMMUNICATOR": "https://..." }
    }
  }
}

Installation

Up and running in minutes

Simple installation with uv package manager

Clone the repository

Terminal

git clone https://github.com/saumon/kommunicator.git
cd kommunicator

Install dependencies

Terminal

uv sync

Configure your webhook

Environment variable

export TEAMS_WEBHOOK_KOMMUNICATOR=\
'https://your-webhook-url'

Start communicating!

Send your first message

./kommunicator-cli.py send-teams \
  --to john \
  --message "Hello! 👋"

Prerequisites

🐍 Python >= 3.14

📦 uv (Python package manager)

☁️ Office 365 with Power Automate access

Open Source

Built with ❤️ for the community

Kommunicator™ is completely open source and released under the MIT License. We believe in the power of collaboration and welcome contributions from developers around the world.

🐛 Report bugs

💡 Suggest features

🔧 Submit pull requests

📖 Improve documentation

Contribute on GitHub

👩‍💻 👨‍💻 🧑‍💻 👩‍💻 👨‍💻 🧑‍💻