outlook-mcp/CHANGELOG.md

Comprehensive MCP server for Claude to access Microsoft Outlook and Teams via Microsoft Graph API - including Email, Calendar, Contacts, Tasks, Teams, Chats, and Online Meetings

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [2.0.1] - 2024-12-XX

### Fixed
- **Graceful Authentication Handling**: Tools now show friendly authentication messages instead of errors when no token is present
- **Improved User Experience**: Users can now interact with the MCP server and get helpful authentication guidance without encountering errors
- **Better Error Messages**: All tools now provide clear instructions on how to authenticate when authentication is required

### Changed
- **Authentication Flow**: `ensureAuthenticated()` now returns `null` instead of throwing errors when no token is present
- **Tool Responses**: All tools now use `createAuthRequiredResponse()` to provide consistent authentication guidance

## [2.0.0] - 2024-12-XX

### Added
- **Teams Integration (25 tools)**: Complete Microsoft Teams functionality
  - Teams management: list teams, get team details, list team members
  - Channels management: create, update, delete, list channels
  - Messages: send/reply to channel messages, list channel messages
  - Chats: create chats, send chat messages, list chats and chat messages
  - Presence: get/set user presence, get multiple users presence
  - Online meetings: create, update, delete, list online meetings
- **Contacts Management (8 tools)**: Full contact lifecycle management
  - CRUD operations for contacts
  - Contact folders management
  - Contact search functionality
- **Tasks Integration (7 tools)**: Microsoft To-Do integration
  - Task management: create, update, delete, list tasks
  - Task lists management: create, delete, list task lists
- **Enhanced Email Management**: Expanded from 4 to 17 tools
  - Email attachments handling
  - Reply and forward functionality
  - Email categories management
  - Draft management
  - Mark read/unread functionality
- **Enhanced Calendar Management**: Expanded from 4 to 12 tools
  - Calendar management: create, update, delete calendars
  - Event search functionality
  - Event response handling (accept, decline, tentative)
- **Folder Management (3 tools)**: Mail folder operations
- **Rules Management (3 tools)**: Email rules automation
- **Test Mode**: Comprehensive mock data for all modules
- **Modular Architecture**: Clean separation into 8 functional modules

### Changed
- **Major Version Bump**: From 1.0.0 to 2.0.0 due to extensive new functionality
- **Enhanced Documentation**: Comprehensive README with all 72+ tools
- **Improved Error Handling**: Better error messages and handling across all modules
- **Updated Dependencies**: Latest MCP SDK and dependencies

### Technical Details
- **Total Tools**: 72+ tools across 8 modules
- **New Modules**: contacts, tasks, teams (with 6 submodules)
- **Enhanced Modules**: email, calendar
- **New Permissions**: Added 15+ new Microsoft Graph API permissions
- **Architecture**: Modular design with consistent patterns across all modules

## [1.0.0] - 2024-11-XX

### Added
- **Initial Release**: Basic Outlook MCP server
- **Authentication**: OAuth 2.0 with Microsoft Graph API
- **Email Management**: Basic email operations (list, search, read, send)
- **Calendar Management**: Basic calendar operations (list, create, delete events)
- **Folder Management**: Basic folder operations
- **Rules Management**: Basic rules operations
- **Test Mode**: Mock data for development
- **MCP Compatibility**: Full Model Context Protocol support

### Technical Details
- **Total Tools**: ~20 tools across 4 modules
- **Core Modules**: auth, email, calendar, folder, rules
- **Basic Permissions**: Mail.Read, Mail.Send, Calendars.Read, Calendars.ReadWrite
- **Architecture**: Modular structure with clean separation of concerns

---

## Version Comparison

| Version | Total Tools | Modules | Key Features |
|---------|-------------|---------|--------------|
| 1.0.0   | ~20 tools   | 4 modules | Basic Outlook (Email, Calendar) |
| 2.0.0   | 72+ tools   | 8 modules | Full Microsoft 365 (+ Teams, Contacts, Tasks) |

## Migration Guide

### From 1.0.0 to 2.0.0

**New Requirements:**
- Additional Azure permissions (see README.md)
- No breaking changes to existing tools
- All 1.0.0 functionality is preserved

**New Capabilities:**
- Teams integration for complete collaboration
- Contacts management for relationship tracking
- Tasks integration for productivity workflows
- Enhanced email with attachments and categories
- Advanced calendar management

**Configuration Changes:**
- Add new Microsoft Graph API permissions
- No changes to existing configuration required
- All existing tools continue to work as before