plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "glasp",
  "version": "1.1.2",
  "description": "Answer from the passages you highlighted while reading, quoted word for word with their sources.",
  "author": {
    "name": "Glasp Inc.",
    "email": "hi@glasp.co",
    "url": "https://glasp.co/mcp"
  },
  "homepage": "https://glasp.co/mcp",
  "keywords": [
    "highlights",
    "reading",
    "kindle",
    "notes",
    "research"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Glasp",
        "shortDescription": "Search your saved highlights",
        "longDescription": "Glasp is a highlighter for people who read a lot. As you read on the web, and in Kindle books you sync to Glasp, you highlight the passages that matter, and Glasp keeps each one with its source.\n\nThis plugin answers from the passages you chose. Ask about a topic and it returns the exact lines you highlighted, word for word, with the title of the page or book each one came from and a link to it. You can:\n\n- Search everything you have highlighted, across web pages and Kindle books\n- See what you highlighted recently, or everything you highlighted on one page\n- Read your Kindle highlights book by book\n- Look back at the pages you highlighted recently and the passages you marked in each\n- List the pages you saved and the AI summaries Glasp made for you\n- See which passages other Glasp readers highlighted publicly on a web page\n- Save a page to your Glasp bookmarks\n\nIt is for researchers, writers and anyone who wants answers grounded in what they actually read and kept.\n\nA Glasp account is required. The plugin reads only your own library, except community highlights, which show passages other readers highlighted publicly on a page, as counts, without saying who. Connecting asks you to approve two things on Glasp's permission screen: reading your library and saving pages to your bookmarks. Saved bookmarks are public on your Glasp profile. The plugin cannot create highlights, write new summaries, or edit or delete anything.",
        "developerName": "Glasp Inc.",
        "category": "Productivity",
        "capabilities": [
          "Search your highlights",
          "Browse recent highlights",
          "Read Kindle highlights",
          "List bookmarks and AI summaries",
          "See what other readers highlighted on a page",
          "Save a page to your bookmarks"
        ],
        "websiteURL": "https://glasp.co/mcp",
        "supportURL": "https://glasp.co/support",
        "privacyPolicyURL": "https://glasp.co/privacy-policy",
        "termsOfServiceURL": "https://glasp.co/terms-of-service",
        "defaultPrompt": [
          "What have I highlighted about habits?",
          "Show me what I highlighted most recently.",
          "Find quotes I saved about learning, with their sources."
        ],
        "brandColor": "#5C94FF",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Search the user's own highlights by topic and answer with verbatim quotes and sources",
              "prompt": "What have I highlighted about building habits?",
              "tools_triggered": "search_highlights",
              "expected_behavior": "Calls search_highlights and answers from passages in the test account's own highlights about habits, each shown with its source title and link (the tool returns the passages verbatim). With the test data this includes James Clear's \"How to Build New Habits by Taking Advantage of Old Ones\", for example \"One of the best ways to build a new habit is to identify a current habit you already do each day and then stack your new behavior on top. This is called habit stacking.\", and may include passages from \"Habit - Wikipedia\" and the user's notes on them. It does not invent passages that the tool did not return."
            },
            {
              "description": "List what the user highlighted most recently, grouped by page",
              "prompt": "Show me what I highlighted most recently.",
              "tools_triggered": "list_recent_highlights",
              "expected_behavior": "Calls list_recent_highlights and lists the pages the test account highlighted most recently, newest first, each with its title, a link and the highlighted passages, plus the user's note where there is one. With the test data the seven most recent are about learning and habits: James Clear's \"How to Build New Habits by Taking Advantage of Old Ones\", Paul Graham's \"How You Know\" and \"The Top Idea in Your Mind\", the Feynman technique article, and the Wikipedia pages \"Habit\", \"Practice (learning method)\" and \"Spaced repetition\". Older pages may follow."
            },
            {
              "description": "Read the user's Kindle highlights book by book",
              "prompt": "What did I highlight in my Kindle books?",
              "tools_triggered": "list_kindle_highlights",
              "expected_behavior": "Calls list_kindle_highlights and lists the three books in the test account, \"How to Live on 24 Hours a Day\" by Arnold Bennett, \"Meditations\" by Marcus Aurelius and \"Walden\" by Henry David Thoreau, each with the passages highlighted in it (for example \"Our life is frittered away by detail.\" from Walden)."
            },
            {
              "description": "Show which passages other Glasp readers highlighted on a public page, without identifying anyone",
              "prompt": "What did other Glasp readers highlight on https://paulgraham.com/greatwork.html?",
              "tools_triggered": "get_community_highlights",
              "expected_behavior": "Calls get_community_highlights and returns up to five passages that two or more Glasp readers independently highlighted on that page, each with how many readers marked it, and how many readers were in the sample. On 2026-10-04 the top passage, beginning \"The first step is to decide what to work on.\", had 17 readers in a sample of 72; the counts change as people read the page. It names no reader and does not present these passages as the user's own highlights."
            },
            {
              "description": "Save a page to the user's Glasp bookmarks after the user confirms the write",
              "prompt": "Save https://en.wikipedia.org/wiki/Testing_effect to my Glasp bookmarks.",
              "tools_triggered": "save_bookmark",
              "expected_behavior": "Because save_bookmark is not read-only, the client asks the user to approve the save before it runs (ChatGPT does, unless it was already allowed in this conversation). After approval, Glasp saves the page and reports the title it read from the page itself (\"Testing effect - Wikipedia\") and that bookmarks are public on the user's profile. If the page was already saved, the tool says so and nothing changes."
            }
          ],
          "negative": [
            {
              "description": "Creating a highlight is out of scope: the plugin has no tool that writes highlights (save_bookmark only saves a whole page by its URL). ChatGPT should say it cannot add highlights to Glasp, and should not call save_bookmark or any other Glasp tool to imitate one.",
              "prompt": "Highlight this sentence in my Glasp library: \"The best way to learn is to teach.\""
            },
            {
              "description": "Deleting is out of scope: the plugin cannot delete or edit anything in Glasp. ChatGPT should say it cannot delete Glasp bookmarks (they can be removed on the Glasp website) and must not call save_bookmark. It may list the bookmarks to show what is there, but nothing is deleted or changed.",
              "prompt": "Delete all of my Glasp bookmarks."
            },
            {
              "description": "Another person's library is out of scope: the plugin reads only the signed-in user's own highlights, and community highlights are per page and never say who highlighted what. ChatGPT should say it cannot show another person's highlights, and must not present the user's own highlights as someone else's.",
              "prompt": "Show me what my friend Sarah highlighted on Glasp this week."
            }
          ]
        },
        "demo_recording_url": "https://www.youtube.com/watch?v=vWIrHfPhV0o",
        "commerce": false,
        "commerce_description": "Glasp's plugin does not sell anything or take payments."
      },
      "publication": {
        "countries": [],
        "release_notes": "First release of Glasp for ChatGPT and Codex. Ask about what you have read and get answers in the exact passages you highlighted on the web and in Kindle books, each with its title and a link. Search your highlights by topic, see what you highlighted recently or on one page, read your Kindle highlights book by book, list the pages you saved and the AI summaries Glasp made, see which passages other Glasp readers highlighted publicly on a page (as counts, without names), and save a page to your Glasp bookmarks, which are public on your Glasp profile."
      },
      "apps": "./.app.json"
    }
  }
}