Notelert

Turn any line in your Obsidian notes into a reminder—without leaving your workflow. Type :@, choose when to be reminded, and select where it should arrive: Android, email, Google Calendar, Telegram, or several channels at once.

Android is optional for date and time reminders. You only need the Android app for Android push notifications and location-based reminders.

What you can do

• Schedule one-time reminders with a date and time.
• Use quick actions such as today, tomorrow, in one hour, and in two hours.
• Create daily, weekly, monthly, or yearly recurring reminders.
• Deliver a reminder through Android push, email, Google Calendar, Telegram, or any combination of those channels.
• Receive location reminders when you arrive at a saved place with the Notelert Android app.
• Include a return link that opens the originating Obsidian note.
• Use the settings and reminder picker in Spanish, English, Catalan, French, German, or Portuguese.

First-time setup

Notelert requires an account-linked App link token. You can obtain it from the Notelert Android app or by completing the email account flow in plugin settings.

1. Install and enable Notelert in Obsidian.
2. Open Settings → Notelert.
3. Link an existing App link token or verify your email.
4. Enable the delivery channels you want:
   • Email: enter and verify the delivery address once.
   • Google Calendar: enable its toggle and approve Google OAuth once.
   • Telegram: enable its toggle, open the Notelert bot, and press Start once.
   • Android: open the Notelert Android app and link the same account.
5. Type :@ in a note, select the reminder date and time, and confirm.

Google Calendar and Telegram remain connected until you disconnect them, revoke provider access, or delete your Notelert account.

Network access and external services

Notelert uses remote services because reminders need to run while Obsidian is closed. The plugin connects to Notelert endpoints hosted on Firebase/Google Cloud for authentication, account management, scheduling, and delivery status.

Depending on the channels you enable, Notelert also uses:

• Firebase Cloud Messaging for Android push delivery.
• An email delivery provider for verification and reminder emails.
• Google Calendar API after you grant the calendar.events OAuth permission.
• Telegram Bot API after you connect the Notelert bot.
• Google Maps services for saved locations and location reminders.

Notelert does not run marketing analytics from the Obsidian plugin. Operational records such as request status, delivery status, error type, notification identifier, and service limits may be processed to deliver and secure the service. Notelert also keeps anonymous daily counters for channel selection, connection state, and delivery outcome. Those aggregated counters contain no reminder content, email address, Calendar ID, Telegram chat ID, or Notelert account ID.

For active-user reporting, the backend refreshes the account's latest authenticated activity timestamp at most once every 15 minutes. /ops exposes only aggregate active-user, DAU, and MAU counts, never user lists or account identifiers.

Data sent

When you create a reminder, the plugin sends only the information required for that request:

• Reminder title and the selected reminder line.
• Date, time, recurrence, and selected delivery channels.
• Location name and coordinates for a location reminder.
• An optional Obsidian return link.
• The account-linked App link token in an authenticated request header.
• An email address when you configure email delivery.

Google OAuth tokens and Telegram chat identifiers are stored encrypted on the Notelert backend. They are never returned to or bundled inside the public plugin. Provider secrets and API credentials are also kept server-side.

The plugin does not scan vaults, upload complete notes, read unrelated note content, or collect vault contents for analytics.

Disconnecting and deleting data

Email, Google Calendar, and Telegram can be disconnected from Notelert settings. Account export, installation revocation, and global account deletion are available under Account & privacy.

• Privacy Policy
• Terms and Conditions
• Account deletion

Deleting a Notelert account removes stored integration credentials and pending Notelert data. Calendar events already created in the user's own Google Calendar and Telegram messages already delivered remain under those providers' controls.

Android app

The Android app is available for push and location reminders:

iOS push and location delivery are not currently available. Email, Google Calendar, and Telegram can still be used without an Android device.

Development

npm install
npm run build
npm run release:assets

An Obsidian release contains exactly:

• main.js
• manifest.json
• styles.css

Privacy summary

Notelert processes the reminder line the user explicitly selects and the associated scheduling data. It does not inspect unrelated files or upload full vault contents.