> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Guru

**Authentication:** OAuth or API token. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* Search Guru for cards tagged `customer-onboarding` updated in the last 30 days.
* Find verified cards that haven't been re-verified in 6 months.
* List cards owned by people no longer at the company.

## Available Tools

#### list_boards

List Guru boards with pagination. Boards are home folders that organize cards into structured views. Use cursor from...

#### get_board

Get a Guru board by ID with sections and items. Use list_boards to find board IDs.

#### search_cards

Search Guru cards by keywords with optional filters. Returns up to 50 cards per page. Use token from page_info.cursor...

#### get_card

Get a Guru card by ID with full details including content, owner, collection, and tags. Use search_cards to find card...

#### create_card

Create a new Guru card with title and content. Use list_collections to find a collection ID. Set shareStatus to TEAM...

#### update_card

Update a Guru card's title, content, tags, or share status. Both title (preferredPhrase) and content are required. Us...

#### delete_card

Permanently delete a Guru card. This action cannot be undone. Use get_card to verify the card before deleting.

#### verify_card

Mark a Guru card as verified/trusted. Use search_cards or get_card to find cards needing verification.

#### list_collections

List Guru collections with pagination. Optionally filter by search term. Use cursor from page_info for next page.

#### get_collection

Get a Guru collection by ID with full details. Use list_collections to find collection IDs.

#### list_card_comments

List comments on a Guru card with pagination. Use search_cards or get_card to find card IDs. Use cursor from page_inf...

#### create_card_comment

Add a comment to a Guru card. Use search_cards or get_card to find card IDs.

#### delete_card_comment

Delete a comment from a Guru card. Use list_card_comments to find comment IDs.

#### list_folders

List Guru folders with pagination. Returns folder hierarchy with collection references. Use cursor from page_info for...

#### get_folder

Get a Guru folder by ID with details. Use list_folders to find folder IDs.

#### create_folder

Create a new folder in a Guru collection. Use list_collections to find a valid collection ID.

#### update_folder

Update a Guru folder's title or description. Use get_folder to see current values.

#### delete_folder

Permanently delete a Guru folder. This action cannot be undone.

#### list_folder_items

List items (cards and subfolders) in a Guru folder with pagination. Use list_folders or get_folder to find folder IDs...

#### list_groups

List Guru user groups with pagination. Groups control access to collections and cards. Use cursor from page_info for...

#### list_members

List Guru team members with pagination. Returns roles and status. Use cursor from page_info for next page.

#### list_tag_categories

List Guru tag categories with their tags and pagination. Each category contains tags that can be applied to cards. Us...

#### create_tag

Create a new tag in a Guru tag category. Use list_tag_categories to find valid category IDs.

#### list_templates

List Guru card templates with pagination. Templates provide reusable content structures for creating cards. Use curso...

#### get_template

Get a Guru card template by ID with full content. Use list_templates to find template IDs.