# AISecretary

AISecretary is a collection of MCP servers designed to automate the tasks of a virtual secretary insede the Outlook suite. Each server handles a specific tool, such as:
- Outlook Mail
- Outlook Calendar
- Outlook Contacts
- Outlook To Do
- Outlook Mailbox Settings
- Categories

## Features

- **Modular:** Each tool runs as an independent server, so you can start only the ones you need.
- **Easy integration:** Compatible with OpenWebUI and other platforms supporting MCP.
- **Extensible:** Easily add new servers for additional tools or services.
- **Automation:** Handles repetitive tasks like checking emails, managing calendars, and more.

## Prerequisites

- [uv](https://github.com/astral-sh/uv) installed (Python environment and dependency manager).
- Python 3.11 or higher.

## Getting Started

Follow the instructions below to configure and run the server:

### Service Setup

To configure the necessary Microsoft Graph API settings, follow this setup guide:

- [Outlook](setups/Microsoft.md)

---

### Running the Server

Run the following command to start the server (replace `server.py` with your actual server file):

#### Recommended: Using Claude Desktop

If you have Claude Desktop installed:

```bash
uv run mcp install server.py
```

Other option to install your server in Claude Desktop is to edit the configuration file at:
`C:\Users\YOUR_USER\AppData\Roaming\Claude\claude_desktop_config.json`

```config
{
  "mcpServers": {
    "Server_name": {
      "command": "/Your/path/to/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "msal",
        "mcp",
        "run",
        "/your/path/to/server.py"
      ]
    },
  }
}
```

If you want all the MCP servers you can just also run the script `claude_setup.py` wity `uv`.
```
uv run python claude_setup.py
```
#### Alternative: Running with OpenWebUI

If you're using platforms like OpenWebUI:

```bash
uvx mcpo --port 9000 -- uv run mcp run server.py
```

Then open **OpenWebUI**, go to:

```
Settings > Tools > [+]
```

Add the following URL:

```
http://127.0.0.1:9000
```

You can now interact with **AISecretary** through the OpenWebUI interface.

## Functionalities

These are the available functionalities for each of the MCP servers:

### 📧 Email

#### Email Management
- Advanced email search  
- Retrieve conversations  
- Mark as read/unread  
- Retrieve full emails with attachments  
- Delete emails  
- Move or copy emails  
- Manage flags  

#### Email Creation and Sending
- Create or edit drafts  
- Handle attachments  
- Send drafts  
- Reply to emails  
- Forward emails  

#### Folder Organization
- View folder structure  
- Create or edit folders  
- Delete folders  
- Navigate folder hierarchy  

#### Mail Rules
- View existing rules  
- Create or edit rules  
- Delete rules  

---

### 🏷️ Categories
- View existing categories  
- Create or edit categories  
- Delete categories  
- Assign categories to emails  
- Assign categories to events  
- Use predefined colors  

---

### 📅 Calendar

#### Event Management
- Retrieve events  
- Create events  
- Update events  
- Delete events  
- Retrieve detailed event information  

#### Invitation Handling
- Accept invitations  
- Decline invitations  
- Respond tentatively  
- Cancel events  

#### Attachment Management
- Add attachments  
- Remove attachments  

#### Calendar Management
- List calendars  
- Retrieve specific calendars  
- Create calendars  
- Update calendars  
- Delete calendars  

#### Calendar Group Management
- List groups  
- Create groups  
- Update groups  
- Delete groups  

#### Availability Lookup
- Retrieve free/busy schedule  

---

### ✅ Task Management

#### Task List Management
- Retrieve lists
- Create lists
- Delete lists

#### Task Management
- Retrieve tasks
- Retrieve specific task
- Create tasks
- Update tasks
- Delete tasks 

---

### 👥 Contacts

#### Contact Folder Management
- Create folders  
- Delete folders  
- Search folders  

#### Contact Management
- Search contacts  
- Retrieve detailed contact information  
- Create contacts  
- Update contacts  
- Delete contacts  

---

### ⚙️ Mailbox Settings

#### General Settings Management
- Retrieve settings  
- Update settings  

#### Supported Settings
- Automatic replies  
- Time zone  
- Working hours  

## Adding New Servers

To add support for new tools, create a new Python file following the structure of the existing servers and register the functions you want to expose as MCP tools.

## More Information

- [Python original sdk](https://github.com/modelcontextprotocol/python-sdk): Explains how to use MCP with different models and tools.
- [OpenWebUI](https://docs.openwebui.com/openapi-servers/mcp/): Detailed guide on integrating MCP servers with OpenWebUI.
- [Anthropic](https://modelcontextprotocol.io/quickstart/user): Detailed guide on integrating MCP servers with Claude Desktop.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.