obsidian-gmail

Categorize Gmail messages by project and persist summaries into Obsidian notes.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/jeehoon0310/claude-code-config --skill obsidian-gmail
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-gmail
Source: https://github.com/jeehoon0310/claude-code-config/tree/main/project/skills/obsidian-gmail
Command: npx skills add https://github.com/jeehoon0310/claude-code-config --skill obsidian-gmail

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gmail messages often arrive with project context scattered across labels, threads, and external tools. This skill consolidates project-related emails into Obsidian notes and keeps a wiki up to date, reducing context switching and manual curation.

Core Features & Use Cases

  • Automatic project classification: scans Gmail via Gmail MCP and routes emails to the appropriate Obsidian project folders.
  • Summaries, links, and properties: generates concise summaries, links to source mail, and metadata to populate Obsidian notes.
  • Wiki synchronization: updates the central wiki with decisions, action items, and project-wide mentions of emails.

Quick Start

Run the command /obsidian-gmail to start scanning your inbox, classify emails by project, and update Obsidian notes and the wiki.

Frequently Asked Questions about obsidian-gmail

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically organize Gmail messages into Obsidian notes by project?

To organize Gmail into Obsidian notes, this skill scans your inbox via Gmail MCP, classifies messages by predefined sender and keyword mappings, and generates summaries with links routed to specific project folders.

What is project-based email classification for markdown notes?

Project-based email classification is the process of scanning Gmail threads and routing summaries, source links, and metadata into dedicated Obsidian markdown folders to consolidate scattered project context.

How do I keep a centralized wiki updated with Gmail decisions and action items?

You can keep a centralized wiki updated by running the skill to scan Gmail, classify project emails, and automatically synchronize decisions, action items, and project-wide mentions into the wiki.

Do I need Gmail MCP authentication to sync emails with Obsidian vaults?

Yes, you need Gmail MCP authentication to access your inbox, along with predefined mappings between sender keywords and project folders, and access to your Obsidian vault and wiki.

Can I use this email archival workflow for team collaboration artifacts?

Yes, this workflow targets project-based email management by persisting summaries and links into Obsidian notes and a centralized wiki, ensuring consistent archival and collaboration artifacts for teams.

Why are my Gmail messages not routing to the correct Obsidian project folders?

Gmail messages may not route correctly if predefined mappings between sender keywords and project folders are missing, or if Gmail MCP authentication and Obsidian vault access are not properly configured.