Glasp

Glasp for Obsidian

Import your Glasp highlights, notes, summaries, and bookmarks — from the web and from Kindle — directly into your Obsidian vault, and keep them in sync automatically.

Glasp is a social web highlighter that lets you highlight and take notes on the web, PDFs, YouTube, and Kindle, then own and export everything you collect. This plugin brings that knowledge into Obsidian as Markdown notes you fully control.

✨ Features

• 📥 Import web highlights & notes from Glasp into a folder of your choice.
• 📚 Import Kindle highlights & notes into a separate folder, so book highlights stay out of your web notes.
• 📝 Import summaries — your Glasp AI page/video summaries as notes, optionally embedding the full article/PDF text.
• 🔖 Import bookmarks — every page you've saved, as lightweight, metadata-rich notes.
• 🗂️ Database views (Obsidian Bases) — each source gets an auto-generated .base view collected in a dedicated Glasp Bases folder, so you can browse everything as a sortable Table or a Cards gallery with thumbnails. (Requires Obsidian 1.9+.)
• 🔁 Automatic background sync — every hour, every day, or once a week.
• ➕ Incremental — only items changed since the last sync are fetched (with a few minutes of overlap; an item fetched again unchanged is left alone). Existing notes in the output folder are matched by source URL and updated in place, and a note whose content has not changed is left alone, so its modification date stays put. When an item changes on Glasp, its note is written again from the template, so text you add to the note yourself is replaced then; keep your own writing in a separate note. A note you move out of the output folder is no longer updated: when its item changes, a new note is created in the output folder.
• 🧾 Clear sync errors — if an item can't be saved, Settings → Glasp → Last sync errors lists which one, where and why; later syncs try it again (for Create missing notes, run it again).
• 🩹 Create missing notes — one button fetches all your items once and creates a note for each item that has none anywhere in your vault, for example items an earlier version could not save. Notes you moved to another folder stay where they are; notes you deleted are created again.
• 🎨 Customizable templates — define your own Markdown layout and frontmatter for every source, or use the sensible defaults.
• 📱 Desktop & mobile — works anywhere Obsidian runs.

✅ Requirements

• Obsidian 1.9.0 or later (the auto-generated database views use the built-in Bases core plugin). On older versions, use plugin v0.2.x.

📦 Installation

From Obsidian Community Plugins (recommended)

1. Open Settings → Community plugins in Obsidian.
2. Search for “Glasp”, click Install, then Enable.

Manual

1. Download main.js and manifest.json from the latest release.
2. Copy them into [YourVault]/.obsidian/plugins/glasp/.
3. Reload Obsidian and enable Glasp under Community plugins.

🚀 Getting started

📺 Prefer a walkthrough? Follow the full step-by-step tutorial on exporting Glasp highlights into Obsidian.

1. Get your access token from your Glasp account: https://glasp.co/settings/access_token
   • 💡 If the link opens inside Obsidian and you can’t sign in, use the copy button next to the token field and paste the URL into your default browser (Chrome, Safari, etc.).
2. In Settings → Glasp, paste the Access token.
3. Choose an output folder for each source you want — web highlights, Kindle highlights, summaries, and/or bookmarks.
   • Leaving a folder unset simply skips that source, so you can enable any combination.
   • Tip: give each source its own folder to keep them tidy.
4. Pick an update frequency. Your data is imported on startup and then on that schedule. You can also trigger an import any time via the ribbon icon or the command palette (“Glasp: Import highlights”).

Once a source has imported, a matching database view appears in the Glasp Bases folder — open it and switch between Table and Cards at the top.

⚙️ Settings

An output folder must already exist; the plugin does not create it. If it is missing (for example, you deleted it) and there is something to import, that source is skipped and reported under Last sync errors until the folder exists again or you pick another one.

🗂️ Database views (Bases)

For every enabled source, the plugin creates a Bases view in a top-level Glasp Bases folder — for example Glasp Bookmarks.base and Glasp Summaries.base. Each view is a live database over that source's notes, so your imports read like a table instead of a long file list:

• Table view for sorting and scanning by domain, date, tags, etc.
• Cards view with thumbnail covers for a visual gallery.

The views are created once and are not re-created if you delete them, so you're free to customize or remove them. Deleting the whole Glasp Bases folder keeps it deleted, until you enable another source or change a source's output folder (either one writes that view again). To keep the plugin out of your folder structure altogether, turn off Create Bases views.

Bases is a core plugin included with Obsidian 1.9+. Enable it under Settings → Core plugins → Bases if it isn't already.

🎨 Customizing the template

You can fully control how each note looks using Handlebars placeholders. Leave a template empty to use the default.

Web highlights — available variables: {{url}} · {{glasp_url}} · {{thumbnail_url}} · {{tags}} · {{tags_yaml}} · {{updated_at}} · {{content}} · {{#each highlights}}…{{/each}}

Kindle highlights — available variables: {{url}} · {{glasp_url}} · {{author}} · {{thumbnail_url}} · {{tags}} · {{tags_yaml}} · {{updated_at}} · {{content}} · {{#each highlights}}…{{/each}}

Summaries — available variables: {{url}} · {{title}} · {{domain}} · {{thumbnail_url}} · {{created_at}} · {{updated_at}} · {{summary}} · {{content}}

Bookmarks — available variables: {{url}} · {{title}} · {{domain}} · {{category}} · {{description}} · {{thumbnail_url}} · {{created_at}} · {{updated_at}} · {{title_text}} · {{url_text}}

ℹ️ Frontmatter values (e.g. {{title}}, {{domain}}) are emitted already quoted so they can't break the note's Properties — keep them on their own line. The _text variants are unquoted, for use in the note body (e.g. a Markdown link). Keeping the URL property in your template is what lets the plugin match and update existing notes instead of duplicating them. The Glasp property is reserved: keep Glasp: summary in a summaries template and Glasp: bookmark in a bookmarks template, and do not use those two values in the web or Kindle templates.

ℹ️ Use Tags: [{{tags_yaml}}] for tags in frontmatter (the default templates do). Ordinary tags come out exactly as {{tags}} writes them; a tag containing a comma, bracket, quote or other YAML syntax, or one YAML would read as something else (such as true, null or 2024), is quoted, so it can't split into two tags or break the Properties.

Styling each highlight ({{#each highlights}})

{{content}} is the ready-made list of highlights. To lay highlights out yourself, loop over highlights. Each one has:

The eq helper compares two values exactly, so you can pick a style per colour. Put the loop where {{content}} is in the template, below the frontmatter, and keep the frontmatter's URL: {{url}} line: that is how the plugin finds the note again (without it, a new note is created each time the page changes):

---
URL: {{url}}
Tags: [{{tags_yaml}}]
---
{{#each highlights}}
{{#if (eq highlightStyle "1")}}<mark style="background:rgb(242,178,188); color:#000;">{{{highlight}}}</mark>
{{else if (eq highlightStyle "2")}}<mark style="background:rgb(249,213,108); color:#000;">{{{highlight}}}</mark>
{{else if (eq highlightStyle "3")}}<mark style="background:rgb(175,213,151); color:#000;">{{{highlight}}}</mark>
{{else if (eq highlightStyle "4")}}<mark style="background:rgb(181,205,238); color:#000;">{{{highlight}}}</mark>
{{else}}{{{highlight}}}
{{/if}}
{{#if note}}> [!Note] {{{note}}}{{/if}}

{{/each}}

highlightStyle is a string, so compare it with a quoted number ("1"), or compare color instead ((eq color "pink")).

---
URL: {{url}}
Glasp URL: {{glasp_url}}
Thumbnail: {{thumbnail_url}}
Tags: [{{tags_yaml}}]
Last updated: {{updated_at}}
---
{{content}}

---
URL: {{url}}
Glasp URL: {{glasp_url}}
Author: {{author}}
Thumbnail: {{thumbnail_url}}
Tags: [{{tags_yaml}}]
Last updated: {{updated_at}}
---
{{content}}

---
Glasp: summary
URL: {{url}}
Title: {{title}}
Domain: {{domain}}
Thumbnail: {{thumbnail_url}}
Created: {{created_at}}
Updated: {{updated_at}}
---

## Summary

{{summary}}
{{content}}

---
Glasp: bookmark
URL: {{url}}
Title: {{title}}
Domain: {{domain}}
Category: {{category}}
Description: {{description}}
Thumbnail: {{thumbnail_url}}
Created: {{created_at}}
Updated: {{updated_at}}
---

[{{title_text}}](<{{url_text}}>)

📝 New note names

A new note is named after the item's title, cleaned so every platform Obsidian runs on accepts it: characters such as [ ] | : \ / # ^ " * ? < > are removed, a Windows device name (CON, NUL, COM1…) gets a leading _, trailing dots and spaces are dropped, and the name is kept within 120 bytes. When two items end up with the same name, the second gets (2), and so on. Notes that already exist keep their names: they are found by the URL in their frontmatter.

🔒 Privacy & security

• Your access token is stored locally in your vault (.obsidian/plugins/glasp/data.json) and is used only to call the official Glasp API at https://api.glasp.co.
• The plugin has read-only access to your own content. It never sends your notes anywhere.
• ⚠️ If you sync or share your vault, be aware that data.json contains your token — treat it like a password. Never paste the whole file into an issue or a chat; if you are asked for a value from it, copy only that line.
• data.json also keeps the last sync's error list, which includes the titles and URLs of the items that failed, and, for each source, the URLs of the items most recently synced (at most 2,000 per source), so that the next sync leaves them alone when they have not changed.
• If you sync the vault to other devices, update the plugin on all of them: a device on 0.3.0 does not know Create Bases views, and the plugin keeps this device's setting when such a device saves the file.

🛠️ Development

git clone https://github.com/glasp-co/obsidian-glasp-plugin
cd obsidian-glasp-plugin
npm install
npm run dev      # watch & rebuild
npm test         # run unit tests
npm run build    # production build

To develop against a live vault, clone into [YourVault]/.obsidian/plugins/ and run npm run dev.

🐞 Bugs & feedback

Found a bug or have a feature request? Please open an issue.

🔗 Links

• 🌐 Glasp — highlight & organize what you read
• 📖 Glasp API documentation
• 📺 Tutorial: Export highlights into Obsidian
• 🔑 Get your access token
• 🧩 Obsidian

License

MIT © Glasp