Outlook

🚀 Enhanced Outlook MCP Server

This is an enhanced, modular implementation of the Outlook MCP (Model Context Protocol) server, which connects Claude to Microsoft Outlook via the Microsoft Graph API. The server offers a powerful set of tools for email, calendar, folder management, and rule creation.

✨ Features

• Comprehensive Authentication System: Supports Microsoft Graph API authentication with OAuth 2.0, featuring token refresh and multi - user support.
• Email Management: List, search, read, send, and organize emails, with support for attachment handling.
• Calendar Integration: Create, modify, and manage calendar events, with support for attendee tracking.
• Folder Organization: Create, manage, and navigate email folders.
• Rule Engine: Create and manage complex email processing rules.
• Modular Architecture: A clean, layered structure for improved maintainability and scalability.
• Enhanced Error Handling: Detailed error messages and logging.
• Test Mode: Provides mock responses for testing without actual API calls.
• Rate Limiting: Built - in rate limiting to prevent API throttling.
• Multi - Environment Configuration: Supports development, testing, and production environments.

📁 Directory Structure

/enhanced-outlook-mcp/
├── index.js                     # Main entry file
├── config.js                    # Configuration settings
├── .env.example                 # Example environment variables
├── auth/                        # Authentication module
│   ├── index.js                 # Authentication export
│   ├── token-manager.js         # Token storage and refresh
│   ├── multi-user-support.js    # Multi-user support
│   └── tools.js                 # Authentication-related tools
├── email/                       # Email functionality
│   ├── index.js                 # Email export
│   ├── list.js                  # List emails
│   ├── search.js                # Search emails
│   ├── read.js                  # Read emails
│   ├── send.js                  # Send emails
│   └── attachments.js           # Handle email attachments
├── calendar/                    # Calendar functionality
│   ├── index.js                 # Calendar export
│   ├── create-event.js          # Create calendar events
│   ├── list-events.js           # List calendar events
│   ├── update-event.js          # Update calendar events
│   └── delete-event.js          # Delete calendar events
├── folder/                      # Folder management
│   ├── index.js                 # Folder export
│   ├── list.js                  # List folders
│   ├── create.js                # Create folders
│   └── move.js                  # Move items in folders
├── rules/                       # Email rule functionality
│   ├── index.js                 # Rule export
│   ├── create.js                # Create email rules
│   ├── list.js                  # List email rules
│   └── delete.js                # Delete email rules
└── utils/                       # Utility functions
    ├── graph-api.js             # Microsoft Graph API helper
    ├── odata-helpers.js         # OData query builder
    ├── logger.js                # Logging tool
    ├── rate-limiter.js          # API rate limiter
    └── config.js                # Configuration file

📦 Installation

1. Clone the repository:

   git clone https://github.com/your-repository/enhanced-outlook-mcp.git
   cd enhanced-outlook-mcp
   

2. Install dependencies:

   npm install
   

3. Configure environment variables:

   • Create a .env file (if it doesn't exist).
   • Add the following content:

     PORT=3000
     GRAPH_API_KEY=your_graph_api_key_here
     

4. Start the server:

   npm start
   

💻 Usage Examples

Basic Configuration

In the config.js file, you can customize the port and other settings as needed.

Authentication

Authenticate using OAuth 2.0. You need to provide a valid Microsoft Graph API token.

Calendar Integration

Manage calendar events by calling create-event.js and other related files.

🔧 Development

• Add New Features: Add new features to the corresponding modules.
• Debugging: Use console.log or other debugging tools for debugging.
• Testing: Run unit tests to ensure the correctness of the code.

📄 License

MIT License

🤝 Contribution

Contributions are welcome! Please feel free to submit a Pull Request.