---
canonical_url: "https://docs.composio.dev/toolkits/glasp"
markdown_url: "https://docs.composio.dev/toolkits/glasp.md"
product: "platform"
version: null
last_updated: null
---

# Glasp

Glasp helps users save bookmarks, capture and organize highlights, import Kindle highlights, and access AI-generated summaries.

- **Category:** bookmark managers
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 9
- **Triggers:** 0
- **Slug:** `GLASP`
- **Version:** 00000000_00

## Tools

### Create Highlights

**Slug:** `GLASP_CREATE_HIGHLIGHTS`

Create between 1 and 100 highlights in the connected Glasp account in one request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `highlights` | array | Yes | Highlights to create; each item requires title, url, and text. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Highlights

**Slug:** `GLASP_DELETE_HIGHLIGHTS`

Delete one Glasp highlight, or explicitly delete all highlights associated with one source document.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Source document URL containing the highlight or highlights to delete. |
| `highlight_id` | string | No | ID of one highlight to delete; required unless delete_document is true. |
| `delete_document` | boolean | No | Set true to delete all highlights for the source URL; when true, highlight_id is ignored. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Summary

**Slug:** `GLASP_GET_SUMMARY`

Fetch one Glasp summary by ID, optionally including the stored page or PDF Markdown content when available.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `summary_id` | string | Yes | Summary ID returned by LIST_SUMMARIES, formatted by Glasp as '{sha1}:{uid}'. |
| `include_content` | boolean | No | When true, request the stored page or PDF Markdown body; content may still be null for YouTube or older summaries. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Bookmarks

**Slug:** `GLASP_LIST_BOOKMARKS`

Return one page of pages the connected user saved to Glasp without highlighting, optionally limited to bookmarks updated after a timestamp.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next_cursor` | string | No | Continuation cursor returned as next_cursor by a previous call; omit for the first page. |
| `updated_after` | string | No | ISO 8601 timestamp; return only bookmarks updated after this time. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Highlights

**Slug:** `GLASP_LIST_HIGHLIGHTS`

Return one page of the connected user's non-Kindle Glasp documents and their nested highlights, optionally limited to records updated after a timestamp.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next_cursor` | string | No | Continuation cursor returned as next_cursor by a previous call; omit for the first page. |
| `updated_after` | string | No | ISO 8601 timestamp; return only documents with highlights updated after this time. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kindle Highlights

**Slug:** `GLASP_LIST_KINDLE_HIGHLIGHTS`

Return one page of the connected user's read-only Kindle books and highlights imported into Glasp, optionally limited to records updated after a timestamp.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next_cursor` | string | No | Continuation cursor returned as next_cursor by a previous call; omit for the first page and pass it back unchanged. |
| `updated_after` | string | No | ISO 8601 timestamp; return only Kindle records updated after this time. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Summaries

**Slug:** `GLASP_LIST_SUMMARIES`

Return one page of AI summaries generated by the connected user for pages, PDFs, and YouTube videos, optionally limited to records updated after a timestamp.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next_cursor` | string | No | Continuation cursor returned as next_cursor by a previous call; omit for the first page. |
| `updated_after` | string | No | ISO 8601 timestamp; return only summaries updated after this time. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Save Bookmark

**Slug:** `GLASP_SAVE_BOOKMARK`

Save a URL as a Glasp bookmark, or update the existing bookmark when that URL is already saved.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | URL to save or re-save. |
| `title` | string | No | Bookmark title; Glasp defaults it to the URL when omitted. |
| `category` | string ("article" | "video" | "tweet" | "pdf" | "book") | No | Content category; Glasp infers it from the URL when omitted. |
| `description` | string | No | Description of the bookmarked page. |
| `thumbnail_url` | string | No | Thumbnail URL for the bookmark. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Highlight

**Slug:** `GLASP_UPDATE_HIGHLIGHT`

Update editable fields on one Glasp highlight identified by its source URL and highlight ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Source document URL returned by list or create highlights. |
| `note` | string | No | Replacement note for the highlight. |
| `text` | string | No | Replacement highlighted text. |
| `color` | string ("pink" | "yellow" | "blue" | "green") | No | Replacement highlight color. |
| `location` | number | No | Replacement position in the source. |
| `highlight_id` | string | Yes | ID of the highlight to update. |
| `highlight_url` | string | No | Replacement deep link to the highlight. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |