# Linkhut

LinkHut manages bookmarked links in a minimalistic, shareable interface, helping teams organize URLs and track references in one place

- **Category:** bookmark managers
- **Auth:** OAUTH2
- **Composio Managed App Available?** Yes
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `LINKHUT`
- **Version:** 20260211_00

## Tools

### Add bookmark

**Slug:** `LINKHUT_ADD_BOOKMARK`

Adds a new bookmark to LinkHut. The bookmark can be marked as private/public and read/unread, with optional tags and notes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The URL of the webpage to bookmark |
| `tags` | string | No | Comma-separated list of tags for the bookmark |
| `shared` | boolean | No | Whether the bookmark should be public (true) or private (false) |
| `toread` | boolean | No | Whether to mark the bookmark as unread |
| `extended` | string | No | Additional notes or description for the bookmark |
| `description` | string | Yes | The title or description of the bookmark |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 bookmark

**Slug:** `LINKHUT_DELETE_BOOKMARK`

This tool allows users to delete a bookmark from their Linkhut account by providing the bookmark URL. It operates independently and only requires the URL parameter to identify and remove the bookmark.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The URL of the bookmark to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 all tags

**Slug:** `LINKHUT_GET_ALL_TAGS`

Retrieves a list of all tags and their usage counts for the authenticated user. No additional parameters required besides authentication.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 bookmarks

**Slug:** `LINKHUT_GET_BOOKMARKS`

Retrieves bookmarks from the user's Linkhut account with optional filtering. This tool fetches bookmarks from Linkhut and supports filtering by: - Tag: Filter by one or more tags (space-separated) - Date: Filter by a specific date (ISO8601 format) - URL: Get a specific bookmark by its exact URL - Meta: Request additional metadata about bookmarks Returns a list of bookmarks with details including URL, title/description, tags, extended notes, timestamp, privacy status (shared), and read status (toread).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `dt` | string | No | Filter by date in ISO8601 format (CCYY-MM-DDThh:mm:ssZ). Returns bookmarks saved on this specific date. If not specified, returns bookmarks from the most recent date |
| `tag` | string | No | Filter bookmarks by tag. You can filter by multiple tags by separating them with spaces (e.g., 'tech learning') |
| `url` | string | No | Filter by a specific URL. Returns the bookmark for this exact URL if it exists |
| `meta` | string | No | Include additional metadata in the response. Set to 'yes' to request metadata |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 Bookmark

**Slug:** `LINKHUT_UPDATE_BOOKMARK`

This tool allows users to update an existing bookmark in LinkHut. The tool updates the metadata of a bookmark including its title, description, and tags.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The URL of the bookmark to update |
| `tags` | string | No | Comma-separated list of tags for the bookmark |
| `shared` | boolean | No | Whether the bookmark should be public (true) or private (false) |
| `toread` | boolean | No | Whether to mark the bookmark as unread |
| `extended` | string | No | Additional notes or description for the bookmark |
| `description` | string | Yes | The new title or description of the bookmark |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 |