Meeting Note Importer

Meeting Note Importer

An Obsidian plugin that creates structured meeting notes from calendar invites — drop a .ics file or drag a meeting directly from Outlook into Obsidian.

Features

• Drag and drop a .ics file from Finder, Explorer, or any file manager
• Drag a meeting directly from Outlook for Mac — no file export needed
• Click to browse for a .ics file via the file picker
• Populates title, date, attendees, organizer, location, meeting URL, and description automatically
• Skips duplicate notes — if a note for that meeting already exists it is returned without overwriting
• Supports a custom Obsidian template with {{date}} and {{title}} placeholders
• Configurable target folder and heading names for attendees and notes sections
• Localised UI in English, French, and Spanish — automatically follows Obsidian's language setting

Note: This plugin is designed for desktop use. Drag-and-drop and direct Outlook integration rely on desktop APIs. Mobile behaviour is untested.

Usage

Click the calendar icon in the ribbon, or run the command Import meeting note from calendar invite, then:

• Drag a .ics file into the drop zone, or
• Drag a meeting event directly from Outlook for Mac, or
• Click the drop zone to browse for a .ics file

The plugin creates a note in the configured folder and opens it immediately.

Default note structure

---
title: "2024-06-15 - Team Sync"
date: "2024-06-15"
tags:
  - meeting
---
# 2024-06-15 - Team Sync

## Attendees
- Jane Smith (Organizer)
- John Doe

## Notes
> https://teams.microsoft.com/meet/...

## Summary

## Action Items

- [ ]

Settings

Localisation

The plugin UI is available in English (default), French, and Spanish. The language is detected automatically from Obsidian's language setting (via the built-in moment.js locale).

To add a new language:

1. Copy src/ts/i18n/en.json to src/ts/i18n/<code>.json (e.g. de.json)
2. Translate all values — keys must stay identical to en.json
3. Import and register it in src/ts/i18n.ts:

   import de from "./i18n/de.json";
   const locales = { en, fr, es, de };
   

4. Rebuild with npm run build

Installation

Manual

1. Download main.js, manifest.json, and styles.css from the latest release
2. Copy them into your vault at .obsidian/plugins/meeting-note-importer/
3. Enable the plugin in Settings → Community plugins

Development

# Install dependencies
npm install

# Copy .env.example and set your vault plugin path
cp .env.example .env

# Development build (with sourcemaps)
npm run dev

# Production build
npm run build

# Copy dist/ to your local vault (reads OBSIDIAN_PLUGIN_DIR from .env)
npm run deploy

# Development build + deploy in one step
npm run dev:deploy

# Remove dist/
npm run clean

Testing

# Run all unit tests
npm test

# Integration test — parse a real .ics file and print the generated note
TEST_ICS_FILE=/path/to/invite.ics npm test

# Integration test — parse Outlook meeting text saved to a file
TEST_OUTLOOK_FILE=/path/to/invite.txt npm test

The integration tests are skipped automatically when the env vars are not set, so npm test always works without any fixtures.

To get a .ics file from Outlook for Mac: right-click a calendar event → Export…, or drag the event from Calendar.app to Finder.

Releases

Push a version tag to trigger a GitHub Actions build and draft release:

git tag v1.0.0
git push origin v1.0.0

The release will contain main.js, manifest.json, and styles.css as flat assets ready for manual installation.