# Obsidian Plugin: Granola Meetings Simple Sync

Sync your [Granola](https://granola.ai) meeting notes to Obsidian.

This plugin uses [Granola's official MCP API](https://docs.granola.ai/help-center/sharing/integrations/mcp) to sync meeting notes, AI summaries, and transcripts into your vault. One-time OAuth setup, then fully automatic.

## Features

- **Official API**: Uses Granola's MCP API with OAuth authentication
- **Multiple accounts**: Connect more than one Granola account and sync them all into the same vault
- **Auto-sync**: Automatically sync meetings at configurable intervals (1m to 12h)
- **Template-based**: Customize output format with your own template
- **Smart deduplication**: Tracks meetings by ID to avoid duplicates
- **Preserve edits**: Option to skip existing notes so your local changes aren't overwritten
- **Attendee linking**: Automatically link attendees to existing notes by email
- **Transcripts**: Optionally include full meeting transcripts

There are other ([1](https://github.com/dannymcc/Granola-to-Obsidian), [2](https://github.com/tomelliot/obsidian-granola-sync)) Granola plugins for Obsidian, but I found their implementation lacking for my needs. They either had unnecessary complexity or didn't support features like bringing in private notes, linking to attendee Person notes, or customizing the note template/frontmatter. This plugin fits my workflow better.

## Installation

Hopefully Obsidian community plugin directory inclusion will come soon. In the meantime:

### Install via BRAT (recommended)
1. Install the [BRAT plugin](https://github.com/TfTHacker/obsidian42-brat) from Obsidian's community plugins
2. In BRAT settings, click **Add Beta plugin**
3. Enter `philfreo/obsidian-granola-plugin`
4. Enable the plugin in Settings → Community plugins

BRAT will automatically keep the plugin updated.

### Manual Installation
1. Create a folder `<vault>/.obsidian/plugins/granola-meetings-simple-sync/`
2. Download `main.js` and `manifest.json` from the [latest release](https://github.com/philfreo/obsidian-granola-plugin/releases) into that folder
3. Reload Obsidian, then enable the plugin in Settings → Community plugins

## Setup

1. Open plugin settings
2. Click **Connect to Granola** — this opens your browser for OAuth authentication
3. Authorize the plugin in your browser
4. You'll be redirected back to Obsidian automatically
5. Meetings will start syncing!

To sync more than one Granola account, click **Add Granola account** in settings and repeat the OAuth flow. All connected accounts sync into the same folder, deduplicated by meeting ID.

## Settings

![Settings screenshot](docs/options-screenshot.png)

| Setting | Default | Description |
|---------|---------|-------------|
| Time range | Last 30 days | How far back to look for meetings |
| Sync frequency | Every 15 minutes | How often to sync. Options: Manual only, On startup, 1m, 15m, 30m, 60m, 12h |
| Sync transcripts | Off | Include full meeting transcripts (1 extra API call per meeting) |
| Folder path | `Meetings` | Where to save meeting notes |
| Filename pattern | `{date} {title}` | Pattern for filenames. Supports `{date}`, `{title}`, `{id}` |
| Template path | `Templates/Granola.md` | Path to your template file |
| Show ribbon icon | On | Show a sync button in the left sidebar |
| Skip existing notes | On | Don't overwrite notes you've edited |
| Match attendees by email | On | Link attendees to notes with matching email in frontmatter |

## Usage

1. **Sync meetings**: By default your meetings will be synced every 15 minutes. This setting is customizable, and you can also trigger a sync by clicking the ribbon icon, using the command palette ("Granola Meetings Simple Sync: Sync meetings"), or clicking "Sync now" in settings.

## Template Variables

Create a template file to customize how your meeting notes look. Use these variables:

### Core
- `{{granola_id}}` - Unique meeting ID
- `{{granola_title}}` - Meeting title
- `{{granola_date}}` - Date (YYYY-MM-DD)
- `{{granola_url}}` - Link to meeting on Granola web
- `{{granola_start_time}}` - Start time (e.g., "3:00 PM")

### Content
- `{{granola_private_notes}}` - Your notes from the meeting
- `{{granola_enhanced_notes}}` - AI-generated content (Summary, Action Items, etc.)
- `{{granola_transcript}}` - Full transcript (requires "Sync transcripts" enabled)

### Attendees
- `{{granola_attendees}}` - Comma-separated names
- `{{granola_attendees_linked}}` - With Obsidian links: `[[John]], [[Jane]]`
- `{{granola_attendees_list}}` - YAML list format
- `{{granola_attendees_linked_list}}` - YAML list with links

### Conditional Blocks

Use `{{#variable}}...{{/variable}}` to only render content when a variable is non-empty:

```markdown
{{#granola_transcript}}
## Transcript

{{granola_transcript}}
{{/granola_transcript}}
```

### Default Template

If no template exists at the configured path, the plugin creates this default:

```markdown
---
granola_id: {{granola_id}}
granola_url: {{granola_url}}
title: "{{granola_title}}"
date: {{granola_date}}
attendees:
{{granola_attendees_linked_list}}
tags:
  - meeting
  - granola
---
{{#granola_private_notes}}## Notes

{{granola_private_notes}}
{{/granola_private_notes}}
{{#granola_enhanced_notes}}## Summary

{{granola_enhanced_notes}}
{{/granola_enhanced_notes}}
{{#granola_transcript}}

## Transcript

{{granola_transcript}}
{{/granola_transcript}}
```

## Requirements

- **Desktop only**: This plugin requires Node.js APIs available only in Obsidian's desktop app
- **Granola account**: You'll be prompted to authenticate via OAuth on first use

## Development

```bash
npm install
npm run dev       # Build (watch mode)
npm run build     # Build (production)
npm run package   # Package for release
```

### Releasing

Per [Obsidian's guidelines](https://github.com/obsidianmd/obsidian-sample-plugin), tags should **not** use a `v` prefix (use `1.0.0`, not `v1.0.0`).

## License

MIT