Guru

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

  • Availability: Experimental (how to enable).
  • Authentication: Basic auth.
  • Connection: HTTP Basic auth with GURU_USERNAME as the username and GURU_USER_TOKEN as the password.
  • Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
GURU_USERNAMEYesHTTP Basic username: your Guru user email (for a User token) or the collection ID (for a Collection token) Docs.
GURU_USER_TOKENYesHTTP Basic password: the Guru User or Collection API token generated in API Access settings Docs.

Setup

  1. Get a Guru account: Sign up at https://www.getguru.com - a free trial workspace is enough for testing the API.
  2. Generate an API token: In Guru, open Settings → API Access and generate a token. A User token (username = your email) acts as you across the knowledge base; a Collection token (username = collection ID) gives read-only access to one collection. Admins can issue tokens for other users.
  3. Store the credentials: Add GURU_USERNAME=<your email or collection ID> and GURU_USER_TOKEN=<your token> to your .env file. The API uses HTTP Basic auth against https://api.getguru.com/api/v1.
  4. Verify access: Run the List Collections tool (or GET /api/v1/teams with curl) - a successful response confirms your credentials work.

Provider notes

  • Collection tokens are read-only and scoped to a single collection - use a User token for the Create Card and Verify Card tools
  • Card search returns at most 50 results per page; narrow your search terms instead of paging when possible
  • shareStatus must be TEAM for a card to be visible to the whole team

Provider API reference.

Tools

ToolAccessDescription
Search Cards<br /><code className="reference-identifier">guru__search_cards</code>ReadSearch cards
Get Card<br /><code className="reference-identifier">guru__get_card</code>ReadGet card
List Collections<br /><code className="reference-identifier">guru__list_collections</code>ReadList collections
Create Card<br /><code className="reference-identifier">guru__create_card</code>WriteCreate card
Update Card<br /><code className="reference-identifier">guru__update_card</code>WriteUpdate card
Verify Card<br /><code className="reference-identifier">guru__verify_card</code>WriteMark card as verified

Verify the connection

Call a read tool such as guru__search_cards with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.