# 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 | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.toolhouse.ai/toolhouse/integrations/linkhut.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.