MCP Notmuch Sendmail

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Uses LaTeX-inspired styling for email formatting, allowing users to create beautiful, professionally formatted emails with LaTeX aesthetics.

  • Supports composing email content in Markdown format, which is then converted to HTML for sending styled emails with inline images.

MCP Notmuch Sendmail

상태: 잘 작동하며 알려진 버그 없이 매일 사용하고 있습니다.

상태 2: 방금 PyPI에 패키지를 추가하고 사용 설명서를 업데이트했습니다. 문제가 있으면 알려주세요 :)

Claude를 이메일 비서로 활용하세요! MCP Notmuch Sendmail은 Claude Desktop을 Notmuch 이메일 데이터베이스에 연결하여 다음과 같은 기능을 제공합니다.

  • 이메일 스레드를 검색하고 탐색하세요
  • 깨끗한 텍스트 형식으로 대화 보기
  • 마크다운을 사용하여 새 이메일 작성
  • 인용된 콘텐츠의 스마트 중복 제거를 통해 스레드에 답변
  • LaTeX에서 영감을 받은 스타일로 아름다운 이메일을 만들어 보세요.
  • 구성된 스크립트를 실행하여 이메일 데이터베이스를 동기화하세요.

HTML 이메일 렌더링에는 html2text를 사용하고, 인라인 이미지가 포함된 풍부한 HTML 이메일을 작성하기 위해서는 markdown-it을 사용합니다.

설치

UV가 설치되어 있는지 확인하세요:

지엑스피1

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음을 추가하세요:

{ "mcpServers": { "email": { "command": "uvx", "args": ["--from", "mcp-notmuch-sendmail==2025.04.09.174710", "--python", "3.10", "--refresh", "mcp-notmuch-sendmail"] "env": { "NOTMUCH_DATABASE_PATH": "/path/to/your/notmuch/db", "NOTMUCH_REPLY_SEPARATORS": "Pipe|Separated|Phrases", "SENDMAIL_FROM_EMAIL": "your.email@example.com", "SENDMAIL_EMAIL_SIGNATURE_HTML": "<p>Optional HTML signature</p>", "NOTMUCH_SYNC_SCRIPT": "/path/to/your/sync/script.sh", "LOG_FILE_PATH": "/path/to/log/file.log", "DRAFT_DIR": "/path/for/email/drafts" } } } }

환경 변수

  • NOTMUCH_DATABASE_PATH : notmuch 데이터베이스 경로(필수)
  • NOTMUCH_REPLY_SEPARATORS : 파이프로 구분된 텍스트 마커 목록 - 이러한 마커로 시작하는 첫 번째 줄까지 이메일 콘텐츠를 유지하고 인용된 답글을 제거합니다(필수).
  • SENDMAIL_FROM_EMAIL : 보낸 사람: 필드에 입력하는 이메일 주소(필수)
  • SENDMAIL_EMAIL_SIGNATURE_HTML : 이메일에 추가할 HTML 서명(선택 사항)
  • NOTMUCH_SYNC_SCRIPT : 이메일 동기화를 위한 스크립트 경로(선택 사항)
  • LOG_FILE_PATH : 로깅 파일 경로(선택 사항)
  • DRAFT_DIR : 이메일 초안을 저장하는 디렉토리(선택 사항, 기본값은 /tmp/mcp-notmuch-sendmail)

API

도구

  • 이메일 스레드 찾기
    • notmuch 데이터베이스에서 이메일 스레드 찾기
    • 입력: notmuch_search_query (문자열)
    • GXP3 형식의 탭으로 구분된 스레드 목록을 반환합니다.
  • 이메일 스레드 보기
    • 이메일 스레드의 모든 메시지 보기
    • 입력: thread_id (문자열)
    • HTML->텍스트 변환 GXP4를 사용하여 대화 내용을 텍스트 형식으로 반환합니다.
  • 새 이메일 작성
    • 마크다운으로 새 이메일 초안을 작성합니다. SENDMAIL_EMAIL_SIGNATURE_HTML을 설정하면 서명이 자동으로 추가됩니다.
    • 입력:
      • subject (문자열): 이메일 제목
      • body_as_markdown (문자열): 마크다운으로 이메일 본문을 작성합니다.
      • to (목록): 수신자 이메일 주소
      • cc (목록, 선택 사항): 참조 수신자
      • bcc (목록, 선택 사항): BCC 수신자
    • 초안 파일을 생성하고 경로를 반환합니다: GXP5
  • 이메일 답장 작성
    • 기존 이메일 스레드에 답장을 작성합니다. SENDMAIL_EMAIL_SIGNATURE_HTML이 설정되어 있으면 서명이 자동으로 추가됩니다.
    • 입력:
      • thread_id (문자열): 답변할 스레드 ID
      • subject (문자열): 이메일 제목
      • body_as_markdown (문자열): 마크다운으로 이메일 본문을 작성합니다.
      • to (목록): 수신자 이메일 주소
      • cc (목록, 선택 사항): 참조 수신자
      • bcc (목록, 선택 사항): BCC 수신자
    • 초안 파일을 생성하고 경로를 반환합니다: GXP6
  • 이메일 보내기
    • 작성된 이메일 초안을 보냅니다.
    • 입력이 필요하지 않습니다
    • 성공/오류 메시지를 반환합니다.
  • 동기화_이메일
    • 구성된 스크립트를 실행하여 이메일을 동기화합니다.
    • 입력이 필요하지 않습니다
    • stdout 및 stderr을 포함한 스크립트의 출력을 반환합니다.
    • NOTMUCH_SYNC_SCRIPT가 구성된 경우에만 사용 가능

답글 구분 기호

NOTMUCH_REPLY_SEPARATORS 환경 변수는 이메일 답장 감지를 제어합니다. 스레드를 볼 때, 각 이메일의 내용은 구성된 구분 기호로 시작하는 첫 줄에서 잘립니다. 이렇게 하면 새 내용은 유지하면서 인용된 답장은 효과적으로 제거됩니다.

다양한 언어에 권장되는 구분자 패턴은 다음과 같습니다.

영어

On|wrote:|From:|Sent:|To:|Subject:|Date:|Cc:|Best regards|Kind Regards|Thanks,|Thank you,|Best,|All the best|regards,|Sent from my|Get Outlook for|CAUTION:|Disclaimer:|Warning:|Confidential:|CONFIDENTIALITY:|---------- Original Message ----------

독일 사람

Am.*schrieb|Von:|Gesendet|An:|Betreff:|Datum:|Cc:|Organisation:|Mit freundlichen Grüßen|Beste Grüße|Viele Grüße|Hinweis:|Achtung:|Gesendet von

프랑스 국민

Le.*a écrit|De |Envoyé |À |Objet |Cc |cordialement|salutations|bonne réception|bonne journée|Envoyé depuis

네덜란드 사람

Op.*schreef:|Van:|Verzonden|Aan:|Onderwerp:|Datum:|Cc:|Met vriendelijke groet|Hartelijke groeten|Bedankt,|Dank u,|Verzonden vanaf

이탈리아 사람

Il.*ha scritto:|Da:|Inviato|A:|Oggetto:|Data:|Cc:|Cordiali saluti|Inviato da

참고: 패턴을 구분하려면 |(파이프)를 사용하세요. 이 패턴들은 일반적인 이메일 클라이언트에서 파생된 단순화된 패턴이므로, 사용자의 특정 요구 사항에 맞게 조정해야 할 수 있습니다.

기여하다

여러분의 참여를 진심으로 환영합니다! 버그 리포트, 기능 요청, 문서 개선, 코드 기여 등 모든 의견은 소중합니다. 자유롭게 다음 내용을 남겨주세요.

  • 버그를 보고하거나 기능을 제안하려면 문제를 열어주세요.
  • 개선 사항을 포함한 풀 리퀘스트 제출
  • 문서를 개선하거나 사용 예를 공유하세요
  • 질문을 하고 경험을 공유하세요

목표는 클로드와 함께 이메일 관리를 더욱 개선하는 것이며, 여러분의 통찰력과 기여가 그 목표 달성에 도움이 될 것입니다.

감사의 말

이 프로젝트는 다른 사람들의 훌륭한 작업을 기반으로 합니다.

  • mail-parser-reply - 포괄적인 이메일 회신 마커 패턴용
  • notmuch - 빠른 메일 인덱싱 및 검색 엔진
  • html2text - HTML 이메일을 읽을 수 있는 텍스트로 변환
  • markdown-it-py - 아름다운 HTML 이메일을 생성하는 데 사용
  • latex.css - LaTeX 스타일 이메일 서식을 위한

특허

모질라 퍼블릭 라이센스 버전 2.0

내 다른 LLM 프로젝트

  • MCP Alchemy - Claude Desktop을 데이터베이스에 연결하여 스키마를 탐색하고 SQL을 실행합니다.
  • MCP Redmine - Claude Desktop에서 Redmine 프로젝트와 이슈를 관리하세요.
  • Diffpilot - 파일 그룹화 및 태그 지정 기능을 갖춘 다중 열 git diff 뷰어입니다.
  • Claude Local Files - Claude Desktop 아티팩트의 로컬 파일에 액세스합니다.
-
security - not tested
A
license - permissive license
-
quality - not tested

Claude Desktop을 notmuch 이메일 데이터베이스에 연결해 주는 이메일 지원 서버로, 이를 통해 사용자는 이메일을 검색하고, 스레드를 보고, 새 메시지를 작성하고, 마크다운 서식을 사용하여 대화에 답장할 수 있습니다.

  1. Installation
    1. Usage with Claude Desktop
      1. Environment Variables
        1. API
          1. Tools
        2. Reply Separators
          1. English
          2. German
          3. French
          4. Dutch
          5. Italian
        3. Contributing
          1. Acknowledgments
            1. License
              1. My Other LLM Projects
                ID: vzg5i81fa1