AISecretary

Uma coleção de servidores MCP para automatizar tarefas de secretária virtual no pacote Microsoft Outlook, gerenciando ferramentas como Mail e Categorias.

GitHub
5
Experimente este MCPPatrocinado

Documentação

AISecretary

AISecretary é uma coleção de servidores MCP projetados para automatizar as tarefas de uma secretária virtual dentro do pacote Outlook. Cada servidor lida com uma ferramenta específica, como:

  • Outlook Mail
  • Outlook Calendar
  • Outlook Contacts
  • Outlook To Do
  • Outlook Mailbox Settings
  • Categories

Recursos

  • Modular: Cada ferramenta roda como um servidor independente, então você pode iniciar apenas os que precisa.
  • Integração fácil: Compatível com OpenWebUI e outras plataformas que suportam MCP.
  • Extensível: Adicione facilmente novos servidores para ferramentas ou serviços adicionais.
  • Automação: Lida com tarefas repetitivas como verificar e-mails, gerenciar calendários e mais.

Pré-requisitos

  • uv instalado (gerenciador de ambiente Python e dependências).
  • Python 3.11 ou superior.

Começando

Siga as instruções abaixo para configurar e executar o servidor:

Configuração do Serviço

Para configurar as definições necessárias da Microsoft Graph API, siga este guia de configuração:

Executando o Servidor

Execute o seguinte comando para iniciar o servidor (substitua server.py pelo seu arquivo de servidor real):

Recomendado: Usando Claude Desktop

Se você tiver o Claude Desktop instalado:

uv run mcp install server.py

Outra opção para instalar seu servidor no Claude Desktop é editar o arquivo de configuração em: C:\Users\YOUR_USER\AppData\Roaming\Claude\claude_desktop_config.json

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

Se você quiser todos os servidores MCP, você também pode executar o script claude_setup.py com uv.

uv run python claude_setup.py

Alternativa: Executando com OpenWebUI

Se você estiver usando plataformas como OpenWebUI:

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

Em seguida, abra OpenWebUI, vá para:

Settings > Tools > [+]

Adicione a seguinte URL:

http://127.0.0.1:9000

Agora você pode interagir com AISecretary através da interface do OpenWebUI.

Funcionalidades

Estas são as funcionalidades disponíveis para cada um dos servidores MCP:

📧 E-mail

Gerenciamento de E-mail

  • Pesquisa avançada de e-mails
  • Recuperar conversas
  • Marcar como lido/não lido
  • Recuperar e-mails completos com anexos
  • Excluir e-mails
  • Mover ou copiar e-mails
  • Gerenciar sinalizadores

Criação e Envio de E-mail

  • Criar ou editar rascunhos
  • Lidar com anexos
  • Enviar rascunhos
  • Responder e-mails
  • Encaminhar e-mails

Organização de Pastas

  • Visualizar estrutura de pastas
  • Criar ou editar pastas
  • Excluir pastas
  • Navegar pela hierarquia de pastas

Regras de E-mail

  • Visualizar regras existentes
  • Criar ou editar regras
  • Excluir regras

🏷️ Categorias

  • Visualizar categorias existentes
  • Criar ou editar categorias
  • Excluir categorias
  • Atribuir categorias a e-mails
  • Atribuir categorias a eventos
  • Usar cores predefinidas

📅 Calendário

Gerenciamento de Eventos

  • Recuperar eventos
  • Criar eventos
  • Atualizar eventos
  • Excluir eventos
  • Recuperar informações detalhadas de eventos

Tratamento de Convites

  • Aceitar convites
  • Recusar convites
  • Responder provisoriamente
  • Cancelar eventos

Gerenciamento de Anexos

  • Adicionar anexos
  • Remover anexos

Gerenciamento de Calendários

  • Listar calendários
  • Recuperar calendários específicos
  • Criar calendários
  • Atualizar calendários
  • Excluir calendários

Gerenciamento de Grupos de Calendários

  • Listar grupos
  • Criar grupos
  • Atualizar grupos
  • Excluir grupos

Consulta de Disponibilidade

  • Recuperar agenda livre/ocupada

✅ Gerenciamento de Tarefas

Gerenciamento de Listas de Tarefas

  • Recuperar listas
  • Criar listas
  • Excluir listas

Gerenciamento de Tarefas

  • Recuperar tarefas
  • Recuperar tarefa específica
  • Criar tarefas
  • Atualizar tarefas
  • Excluir tarefas

👥 Contatos

Gerenciamento de Pastas de Contatos

  • Criar pastas
  • Excluir pastas
  • Pesquisar pastas

Gerenciamento de Contatos

  • Pesquisar contatos
  • Recuperar informações detalhadas de contatos
  • Criar contatos
  • Atualizar contatos
  • Excluir contatos

⚙️ Configurações da Caixa de Correio

Gerenciamento de Configurações Gerais

  • Recuperar configurações
  • Atualizar configurações

Configurações Suportadas

  • Respostas automáticas
  • Fuso horário
  • Horário de trabalho

Adicionando Novos Servidores

Para adicionar suporte a novas ferramentas, crie um novo arquivo Python seguindo a estrutura dos servidores existentes e registre as funções que você deseja expor como ferramentas MCP.

Mais Informações

  • SDK original em Python: Explica como usar MCP com diferentes modelos e ferramentas.
  • OpenWebUI: Guia detalhado sobre integração de servidores MCP com OpenWebUI.
  • Anthropic: Guia detalhado sobre integração de servidores MCP com Claude Desktop.

Licença

Este projeto é licenciado sob a Licença MIT. Consulte o arquivo LICENSE para detalhes.