Granola-to-Obsidian: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

Granola Sync for Obsidian is an Obsidian plugin that automatically syncs meeting notes from Granola AI to an Obsidian vault. It's a standalone Obsidian plugin (not a bundled/compiled project) delivered as three main files: main.js, manifest.json, and styles.css.

• Type: Obsidian plugin
• Language: JavaScript (Node.js)
• Size: main.js is ~2000 lines; all code in a single file
• Version: Currently 1.6.3
• Minimum Obsidian Version: 1.6.6

Architecture & Structure

Single-File Architecture

All plugin code lives in main.js (1994 lines) with two main classes:

1. GranolaSyncPlugin (extends obsidian.Plugin)

   • Main plugin class handling lifecycle, initialization, and sync orchestration
   • Key methods:
     • onload() - Plugin initialization, ribbon icon, settings tab
     • syncNotes() - Main sync orchestration loop (fetches documents, processes them, updates daily notes)
     • loadCredentials() - Reads Granola auth token from local filesystem
     • fetchGranolaDocuments(token) - API call to get meeting notes list
     • fetchTranscript(token, docId) - Optional transcript fetching
     • processDocument(doc) - Converts Granola document to Obsidian note with markdown
     • updateDailyNote() / updatePeriodicNote() - Integrates today's meetings into daily notes
     • Auto-sync setup and interval management

2. GranolaSyncSettingTab (extends obsidian.PluginSettingTab)

   • Settings UI panel with 25+ configurable options
   • Key settings:
     • syncDirectory - Where to save notes (default: "Granola")
     • filenameTemplate - Customizable note naming with tokens like {title}, {created_date}
     • dateFormat - Date formatting (YYYY-MM-DD, DD-MM-YYYY, etc.)
     • autoSyncFrequency - Auto-sync interval in milliseconds
     • includeAttendeeTags - Tag notes with meeting attendees
     • skipExistingNotes - Preserve manual edits in existing notes
     • enableGranolaFolders - Organize by Granola folder structure
     • existingNoteSearchScope - Search strategy for finding duplicates (sync dir, entire vault, or specific folders)