Skip to content

AI-powered PopClip extension to turn natural language into calendar events (Apple/Google), with multilingual, recurring events, reminders, and meeting link parsing.

License

Notifications You must be signed in to change notification settings

cafferychen777/LLMCal

LLMCal — AI Calendar Extension for PopClip

LLMCal Logo

Turn highlighted text into calendar events in seconds

Latest Release GitHub stars License macOS 12+ PopClip 2022.5+

Quick StartFeaturesInstallationUsageFAQ


LLMCal is a PopClip extension that uses AI to convert natural language text into calendar events. Simply highlight text describing an event and click the calendar icon — it automatically extracts titles, times, locations, attendees, meeting links, and reminders.

✨ Key Features

  • 🤖 AI-Powered: Uses Claude AI to understand natural language
  • One-Click Creation: Highlight text → Click calendar icon → Done
  • 🌐 Meeting Links: Auto-detects Zoom, Teams, Google Meet URLs
  • 📍 Smart Locations: Handles both physical and virtual meeting places
  • Intelligent Reminders: Sets alerts based on text descriptions
  • 🔄 Recurring Events: Supports various repeat patterns
  • 👥 Attendees: Extracts email addresses from text
  • 🌍 Time Zones: Understands different time zone formats
  • 📱 Calendar Integration: Works with Apple Calendar and Google Calendar (via macOS sync)

🚀 Quick Start

Prerequisites

  1. macOS 12+ with PopClip installed (download here)
  2. Anthropic API key (get one here)

Installation

  1. Download the latest LLMCal.popclipext.zip from Releases
  2. Double-click the file to install in PopClip
  3. Open PopClip preferences and configure LLMCal with your API key

First Use

  1. Select this text: "Team meeting tomorrow at 2pm for 1 hour"
  2. Click the calendar icon in PopClip
  3. Watch the event appear in your calendar! 🎉

📖 Usage Examples

Simply highlight any of these text examples and click the calendar icon:

"Team meeting tomorrow at 2pm for 1 hour"

"Weekly standup every Monday at 9:30am, 30 minutes, Zoom: https://zoom.us/j/123"

"Product demo next Tuesday 3pm with client@example.com, remind me 15 minutes before"

"Monthly review last Friday of each month, 2-4pm, Conference Room A"

"1:1 with manager Thursday 10am PST (1pm EST), 30 min, Teams: https://teams.microsoft.com/l/123"

🔧 Requirements

  • macOS 12+ (Monterey or later)
  • PopClip 2022.5+ (download)
  • Anthropic API key (get one)
  • Calendar.app access permissions
  • Internet connection for AI processing

📱 Google Calendar Integration

LLMCal works with Google Calendar through macOS integration:

  1. Setup: System Settings → Internet Accounts → Add Google Account → Enable Calendar
  2. Usage: Events created via LLMCal automatically sync to Google Calendar
  3. Sync: Bi-directional sync between Apple Calendar and Google Calendar

❓ FAQ

Q: Does it work with Google Calendar?
A: Yes! Connect your Google account to Apple Calendar in System Settings.

Q: Does it support recurring events?
A: Yes, it understands patterns like "every Monday" or "monthly".

Q: What meeting links are supported?
A: Zoom, Teams, Google Meet, and most other meeting URLs.

Q: Why PopClip instead of a browser extension?
A: Works system-wide in any app (Mail, Notes, Slack) without switching to browser.

Q: How is this different from native calendar parsing?
A: AI-powered extraction is more reliable for attendees, time zones, and complex patterns.

🔒 Privacy & Security

  • API key stored securely in PopClip settings
  • No event data stored or transmitted beyond calendar creation
  • Processing done through Claude AI
  • Minimal permissions: text selection and calendar access

🛠️ Troubleshooting

Calendar Access Issues:

  1. System Settings → Privacy & Security → Full Disk Access → Enable PopClip
  2. Restart Calendar.app

API Key Problems:

  1. Verify key at console.anthropic.com
  2. Check for extra spaces
  3. Restart PopClip after updating

PopClip Not Appearing:

  1. Ensure PopClip is running (menu bar icon visible)
  2. System Settings → Accessibility → Enable PopClip

For more help, see docs/TROUBLESHOOTING.md or open an issue.

🤝 Support & Contributing

📄 License

This project is licensed under the GNU Affero General Public License Version 3 (AGPLv3) with Commons Clause - see the LICENSE file for details.


Made with ❤️ for the macOS community

About

AI-powered PopClip extension to turn natural language into calendar events (Apple/Google), with multilingual, recurring events, reminders, and meeting link parsing.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •