At a glance
- Availability: Experimental (how to enable).
- Auth: Basic auth.
- Connection: HTTP Basic auth with
GURU_USERNAMEas the username andGURU_USER_TOKENas the password. - Docs: https://developer.getguru.com/docs/getting-started
Credentials
Set these per environment. See Connect an integration.Setup
- Get a Guru account: Sign up at https://www.getguru.com - a free trial workspace is enough for testing the API.
- 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.
- 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.
- 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
Tools
| Tool | Access | Description |
|---|---|---|
| Search Cards | Read | Search the knowledge base for cards matching search terms |
| Get Card | Read | Get a single card with its full content and additional details (collection, verifiers, collaborators) |
| List Collections | Read | List the collections in the team to find collection IDs, names, and stats |
| Create Card | Write | Create a new knowledge-base card in a collection |
| Update Card | Write | Update an existing card’s title, content, or visibility to keep knowledge current |
| Verify Card | Write | Mark 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.