Skip to main content

At a glance

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.
  • 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: https://developer.getguru.com/reference

Tools

ToolAccessDescription
Search CardsReadSearch the knowledge base for cards matching search terms
Get CardReadGet a single card with its full content and additional details (collection, verifiers, collaborators)
List CollectionsReadList the collections in the team to find collection IDs, names, and stats
Create CardWriteCreate a new knowledge-base card in a collection
Update CardWriteUpdate an existing card’s title, content, or visibility to keep knowledge current
Verify CardWriteMark a card as verified, confirming its content is accurate and up to date

Example prompts

  • Search my Guru knowledge base for cards about a topic I specify and summarize the verified answer.
  • Turn the information I give you into a well-structured Guru card and create it in the collection I specify.
  • Look up a Guru card I specify, check whether its content still looks accurate, and verify it if so.