MCP Notmuch Sendmail

Estado: Funciona muy bien y se utiliza a diario sin errores conocidos.

Estado 2: Acabo de añadir el paquete a PyPI y actualicé las instrucciones de uso. Por favor, informen cualquier problema.

¡Deja que Claude sea tu asistente de correo electrónico! MCP Notmuch Sendmail conecta Claude Desktop con tu base de datos de correo electrónico de Notmuch, lo que le permite:

• Busque y explore sus hilos de correo electrónico
• Ver conversaciones en un formato de texto limpio
• Redactar nuevos correos electrónicos usando Markdown
• Responder a hilos con deduplicación inteligente del contenido citado
• Cree hermosos correos electrónicos con un estilo inspirado en LaTeX
• Sincronice su base de datos de correo electrónico ejecutando un script configurado

Utiliza html2text para la representación de correo electrónico HTML y markdown-it para componer correos electrónicos HTML enriquecidos con imágenes en línea.

Instalación

Asegúrese de tener instalado el sistema UV:

Uso con Claude Desktop

Añade a tu claude_desktop_config.json :

Variables de entorno

• NOTMUCH_DATABASE_PATH : Ruta a su base de datos notmuch (obligatorio)
• NOTMUCH_REPLY_SEPARATORS : Lista de marcadores de texto separados por barras verticales: mantiene el contenido del correo electrónico hasta la primera línea que comienza con cualquiera de estos marcadores y elimina las respuestas citadas (obligatorio)
• SENDMAIL_FROM_EMAIL : Su dirección de correo electrónico para el campo De: (obligatorio)
• SENDMAIL_EMAIL_SIGNATURE_HTML : Firma HTML para agregar a los correos electrónicos (opcional)
• NOTMUCH_SYNC_SCRIPT : Ruta a un script para sincronizar correos electrónicos (opcional)
• LOG_FILE_PATH : Ruta para el archivo de registro (opcional)
• DRAFT_DIR : Directorio para almacenar borradores de correo electrónico (opcional, el valor predeterminado es /tmp/mcp-notmuch-sendmail)

API

Herramientas

• encontrar_hilo_de_correo_electrónico
  • Encuentre hilos de correo electrónico en la base de datos de notmuch
  • Entrada: notmuch_search_query (cadena)
  • Devuelve una lista de subprocesos separados por tabulaciones con el formato: GXP3
• ver hilo de correo electrónico
  • Ver todos los mensajes de un hilo de correo electrónico
  • Entrada: thread_id (cadena)
  • Devuelve la conversación en formato de texto con conversión HTML->texto GXP4
• redactar_nuevo_correo electrónico
  • Redacte un nuevo borrador de correo electrónico desde Markdown. Se añadirá una firma automáticamente si se configura SENDMAIL_EMAIL_SIGNATURE_HTML.
  • Entradas:
    • subject (cadena): asunto del correo electrónico
    • body_as_markdown (cadena): Cuerpo del correo electrónico en formato Markdown
    • to (lista): Direcciones de correo electrónico de los destinatarios
    • cc (lista, opcional): destinatarios de CC
    • bcc (lista, opcional): destinatarios en CCO
  • Crea archivos de borrador y devuelve rutas: GXP5
• redactar respuesta de correo electrónico
  • Redacta una respuesta a un hilo de correo electrónico existente. Se añadirá una firma automáticamente si se configura SENDMAIL_EMAIL_SIGNATURE_HTML.
  • Entradas:
    • thread_id (cadena): ID del hilo al que responder
    • subject (cadena): asunto del correo electrónico
    • body_as_markdown (cadena): Cuerpo del correo electrónico en formato Markdown
    • to (lista): Direcciones de correo electrónico de los destinatarios
    • cc (lista, opcional): destinatarios de CC
    • bcc (lista, opcional): destinatarios en CCO
  • Crea archivos de borrador y devuelve rutas: GXP6
• enviar_correo electrónico
  • Envía el borrador del correo electrónico redactado
  • No se requiere entrada
  • Devuelve un mensaje de éxito/error
• sincronizar correos electrónicos
  • Sincroniza correos electrónicos ejecutando el script configurado
  • No se requiere entrada
  • Devuelve la salida del script, incluidos stdout y stderr
  • Solo disponible si NOTMUCH_SYNC_SCRIPT está configurado

Separadores de respuesta

La variable de entorno NOTMUCH_REPLY_SEPARATORS controla la detección de respuestas de correo electrónico. Al visualizar un hilo, el contenido de cada correo electrónico se recorta en la primera línea que comience con cualquiera de los separadores configurados. Esto elimina eficazmente las respuestas citadas, conservando el nuevo contenido.

A continuación se muestran patrones separadores recomendados para diferentes idiomas:

Inglés

Alemán

Francés

Holandés

italiano

Nota: Use la barra vertical | para separar los patrones. Estos son patrones simplificados derivados de clientes de correo electrónico comunes; es posible que deba ajustarlos según sus necesidades específicas.

Contribuyendo

¡Agradecemos cualquier contribución! Ya sean informes de errores, solicitudes de funciones, mejoras en la documentación o contribuciones de código, todas las aportaciones son valiosas. No dudes en:

• Abra un problema para informar errores o sugerir funciones
• Enviar solicitudes de extracción con mejoras
• Mejore la documentación o comparta sus ejemplos de uso
• Haz preguntas y comparte tus experiencias

El objetivo es hacer que la gestión del correo electrónico con Claude sea aún mejor, y sus conocimientos y contribuciones ayudan a lograrlo.

Expresiones de gratitud

Este proyecto se basa en el excelente trabajo de otros:

• mail-parser-reply - Para obtener patrones completos de marcadores de respuesta de correo electrónico
• notmuch - El motor de búsqueda e indexación de correo rápido
• html2text : para convertir correos electrónicos HTML en texto legible
• markdown-it-py - Para generar hermosos correos electrónicos HTML
• latex.css - Para el formato de correo electrónico estilo LaTeX

Licencia

Licencia pública de Mozilla versión 2.0

Mis otros proyectos de LLM

• MCP Alchemy : conecta Claude Desktop a bases de datos para explorar esquemas y ejecutar SQL.
• MCP Redmine : deje que Claude Desktop administre sus proyectos y problemas de Redmine.
• Diffpilot - Visor de diferencias Git de varias columnas con agrupación y etiquetado de archivos.
• Archivos locales de Claude : acceda a archivos locales en los artefactos de Claude Desktop.