MCP Gmail API Chatbot

Assistant conversationnel moderne qui gère vos e-mails Gmail via un protocole structuré MCP, en s’appuyant sur un LLM (Groq) et une interface web Streamlit.

Fonctionnalités

• Lecture, envoi, suppression d’e-mails Gmail via des instructions structurées (MCP)
• Interface web moderne (Streamlit)
• Connexion sécurisée à Gmail (OAuth2)
• Réponses conversationnelles classiques si la demande ne concerne pas Gmail

Installation

1. Clone le dépôt

   git clone https://github.com/chamai1/mcp-gmail-api.git
   cd mcp-gmail-api
   

2. Installe les dépendances

   pip install -r requirements.txt
   

   (Crée le fichier requirements.txt si besoin, voir plus bas)

3. Ajoute tes fichiers de secrets (non suivis par git)

   • Place ton fichier credentials.json (Google OAuth) à la racine du projet.
   • Crée un fichier .env à la racine avec :

     GROQ_API_KEY=ta_cle_groq
     GROQ_API_BASE=https://api.groq.com/openai/v1
     GROQ_MODEL=moonshotai/kimi-k2-instruct
     

Lancement

streamlit run app_groq_gmail.py

• Ouvre ensuite http://localhost:8501 dans ton navigateur.

Configuration Gmail

1. Va sur Google Cloud Console
2. Crée un projet et configure l’API Gmail
3. Crée des identifiants OAuth 2.0 (application de bureau)
4. Télécharge le fichier credentials.json et place-le à la racine du projet

Protocole MCP

• Lire : MCP:read:{critère}
• Envoyer : MCP:send:{to}|{subject}|{body}
• Supprimer : MCP:delete:{critère}

Exemples :

• MCP:read:dernier
• MCP:delete:mail de Paul
• MCP:send:paul@email.com|Sujet|Bonjour Paul !

Dépendances principales

• streamlit
• openai
• google-auth-oauthlib
• google-api-python-client
• python-dotenv (si tu veux charger automatiquement le .env)

Exemple de requirements.txt :

streamlit
openai
google-auth-oauthlib
google-api-python-client
python-dotenv

Sécurité

• Ne pousse jamais tes fichiers de secrets (credentials.json, .env, etc.) sur GitHub.
• Les fichiers sensibles sont déjà listés dans .gitignore.

Utilisation

• Lance l’app, connecte-toi à Gmail via l’interface.
• Pose des questions ou donne des instructions (ex : “Lis mes derniers mails”, “Supprime le mail de Paul”, “Envoie un mail à Alice”).
• Le bot répondra soit normalement, soit avec une instruction MCP qui sera exécutée.

Auteurs

• [Menouar chaima]
• [https://github.com/]