> For the complete documentation index, see [llms.txt](https://docs.toolhouse.ai/toolhouse/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.toolhouse.ai/toolhouse/integrations/linkhut.md).

# Linkhut

Your Toolhouse AI Worker can connect to Linkhut using 5 specialized tools.

{% hint style="info" %}
This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=linkhut).
{% endhint %}

## Tools (5)

### `Linkhut Add Bookmark`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example                                   | Description                                                     |
| ------------- | ------- | :------: | ----------------------------------------- | --------------------------------------------------------------- |
| `url`         | string  |     ✅    | `"https://example.com"`                   | The URL of the webpage to bookmark                              |
| `tags`        | string  |          | `"tech,learning,reference"`               | Comma-separated list of tags for the bookmark                   |
| `shared`      | boolean |          | —                                         | Whether the bookmark should be public (true) or private (false) |
| `toread`      | boolean |          | —                                         | Whether to mark the bookmark as unread                          |
| `extended`    | string  |          | `"This is a great resource for learning"` | Additional notes or description for the bookmark                |
| `description` | string  |     ✅    | `"Example Website"`                       | The title or description of the bookmark                        |

***

### `Linkhut Delete Bookmark`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                 | Description                       |
| --------- | ------ | :------: | ----------------------- | --------------------------------- |
| `url`     | string |     ✅    | `"https://example.com"` | The URL of the bookmark to delete |

***

### `Linkhut Get All Tags`

Integration name: **LINKHUT\_GET\_ALL\_TAGS**

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

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

*No parameters required.*

***

### `Linkhut Get Bookmarks`

Integration name: **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).

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                  | Description                                                                                                                                                           |
| --------- | ------ | :------: | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `dt`      | string |          | `"2024-01-01T12:00:00Z"` | 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 |          | `"tech"`                 | Filter bookmarks by tag. You can filter by multiple tags by separating them with spaces (e.g., 'tech learning')                                                       |
| `url`     | string |          | `"https://example.com"`  | Filter by a specific URL. Returns the bookmark for this exact URL if it exists                                                                                        |
| `meta`    | string |          | `"yes"`                  | Include additional metadata in the response. Set to 'yes' to request metadata                                                                                         |

***

### `Linkhut Update Bookmark`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example                               | Description                                                     |
| ------------- | ------- | :------: | ------------------------------------- | --------------------------------------------------------------- |
| `url`         | string  |     ✅    | `"https://example.com"`               | The URL of the bookmark to update                               |
| `tags`        | string  |          | `"updated,tech,reference"`            | Comma-separated list of tags for the bookmark                   |
| `shared`      | boolean |          | —                                     | Whether the bookmark should be public (true) or private (false) |
| `toread`      | boolean |          | —                                     | Whether to mark the bookmark as unread                          |
| `extended`    | string  |          | `"Updated notes about this resource"` | Additional notes or description for the bookmark                |
| `description` | string  |     ✅    | `"Updated Example Website"`           | The new title or description of the bookmark                    |