A plugin that automatically syncs your Substack newsletter subscriptions from Gmail into Obsidian notes.

• 🔄 Automatic syncing of Substack newsletters from Gmail
• 📧 OAuth2 authentication with Gmail API
• 📝 Converts HTML newsletters to clean Markdown
• 🏷️ Adds structured frontmatter with metadata
• ⏰ Configurable auto-sync intervals
• 📁 Organizes newsletters in designated folders
• 🔍 Prevents duplicate imports

1. Google Cloud Console Setup:

   • Create a project in Google Cloud Console
   • Enable the Gmail API
   • Create OAuth 2.0 credentials (Desktop application)
   • Note your Client ID and Client Secret

2. OAuth Token Generation:

   • Use the authorization URL in plugin settings
   • Grant necessary permissions
   • Exchange authorization code for access/refresh tokens

1. Download the latest release files
2. Create folder: VaultFolder/.obsidian/plugins/substack-gmail-sync/
3. Copy main.js, manifest.json, and styles.css to the folder
4. Enable the plugin in Obsidian Settings → Community Plugins

1. Clone this repository
2. Run npm install
3. Run npm run build
4. Copy built files to your vault's plugin directory

1. Gmail API Setup:

   • Enter your Client ID and Client Secret
   • Add your Access Token and Refresh Token

2. Sync Settings:

   • Set target folder for newsletters
   • Configure maximum emails per sync
   • Set auto-sync frequency

• Manual Sync: Click the ribbon icon or use the command palette
• Auto Sync: Configure automatic syncing in settings
• Command: Use "Sync Substack newsletters from Gmail" command

• https://www.googleapis.com/auth/gmail.readonly

1. Authentication Errors:

   • Verify OAuth credentials are correct
   • Check if access token has expired
   • Ensure Gmail API is enabled in Google Cloud Console

2. No Emails Found:

   • Check Gmail search query parameters
   • Verify Substack emails exist in your inbox
   • Increase max emails limit in settings

3. Import Issues:

   • Check folder permissions
   • Verify folder path exists
   • Look for duplicate filename conflicts

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

If you find this plugin helpful, consider:

• ⭐ Starring the repository
• 🐛 Reporting bugs
• 💡 Suggesting features