whatisgithub

What is deskmail-ai?

scrappy-builds/deskmail-ai — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

A private, local Windows email app that connects to Claude Desktop so it can read, search, organise, and draft your email, without ever sending mail or seeing your password.

Mindmap

mindmap
  root((DeskMail AI))
    What it does
      Local Windows email client
      Connects to Claude Desktop
      Keeps data on your PC
    Tech stack
      TypeScript
      Electron
      IMAP and SMTP
      Claude MCP connector
    Use cases
      Manage email with AI help
      Draft replies for review
      Organise inbox automatically
    Audience
      Windows email users
      Claude Desktop users
    Guardrails
      Cannot send mail
      Cannot read password
      Drafts need your approval

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Manage a personal or work email account locally on Windows without cloud-based email services.

USE CASE 2

Ask Claude to summarise unread emails and draft replies that you review before sending.

USE CASE 3

Let Claude organise an inbox by setting up filter rules and moving or labeling messages.

USE CASE 4

Turn emails into calendar events or tasks through the Claude connector.

What is it built with?

TypeScriptElectronNode.jsSQLite

How does it compare?

scrappy-builds/deskmail-ai0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardeasy
Complexity2/54/52/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

The Windows installer is unsigned, so it shows an 'unknown publisher' warning on first run, connecting Claude requires the free Claude Desktop app.

Free to use, modify, and share, including commercially, under the Apache 2.0 license, as long as you keep the copyright notice.

So what is it?

DeskMail AI is a desktop email application for Windows that runs entirely on your own computer and includes a built in connection to Claude, Anthropic's AI assistant. Mail is fetched from your own mail server using standard IMAP and SMTP and stored in a local database on your PC, and your password is encrypted using Windows itself. Nothing is sent anywhere except your own mail server and, only if you choose to connect it, your own copy of Claude Desktop. As an email client on its own, it supports full folder syncing, instant push for new mail, labels, snoozing messages, follow up reminders, filter rules, a junk mail filter that learns over time, rich text composing with attachments and signatures, scheduled sending, an address book, a calendar, contacts, search, and backup and restore. The standout feature is how it connects to Claude Desktop, the separate Claude application, through a local server running on the same PC. Once connected, Claude can read, search, and summarise your mail, draft replies for you to review before sending, organise messages by moving, labeling, archiving, flagging, or snoozing them, set up filter rules, turn emails into tasks or calendar events, look up contacts, and even help set up a new mail account by filling in the form. Claude can never send mail on your behalf, permanently delete anything, read your password, or change your account settings, and any draft it writes waits for you to send it yourself. Someone who does not want to write code can simply download a Windows installer from the project's Releases page and run it. Developers who want to run it from source need Windows 10 or 11, Node.js version 20 or later, and Git, then clone the repository and run standard npm commands to install and launch it. The project is released under the Apache 2.0 license, which allows free use, modification, and sharing as long as the copyright notice stays attached.

Copy-paste prompts

Prompt 1
Help me download and install DeskMail AI on Windows and connect my email account.
Prompt 2
Walk me through connecting DeskMail AI to Claude Desktop using the MCP configuration steps.
Prompt 3
Ask Claude through DeskMail to summarise my unread emails from this week.
Prompt 4
Show me how to have Claude set up a filter rule that moves newsletters into a folder.

Frequently asked questions

What is deskmail-ai?

A private, local Windows email app that connects to Claude Desktop so it can read, search, organise, and draft your email, without ever sending mail or seeing your password.

What language is deskmail-ai written in?

Mainly TypeScript. The stack also includes TypeScript, Electron, Node.js.

What license does deskmail-ai use?

Free to use, modify, and share, including commercially, under the Apache 2.0 license, as long as you keep the copyright notice.

How hard is deskmail-ai to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is deskmail-ai for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.