Access Guru knowledge base via MCP - ask AI questions, search documents, create drafts, and update cards. Connects to all your Guru sources including Slack, Drive, Confluence, and SharePoint.
Access your Guru knowledge base via the official MCP server. Ask AI-powered questions, search documents, create drafts, and update cards.
1. Go to **Guru Admin → API Tokens**
2. Create a new token
3. Note your email and token
Add to `~/.clawdbot/.env`:
```bash
[email protected]:your-api-token
```
Add to `config/mcporter.json`:
```json
{
"mcpServers": {
"guru": {
"baseUrl": "https://mcp.api.getguru.com/mcp",
"headers": {
"Authorization": "Bearer ${GURU_API_TOKEN}"
}
}
}
}
```
```bash
mcporter list guru
```
List all Knowledge Agents in your workspace. **Always call this first** to get agent IDs for other tools.
```bash
mcporter call 'guru.guru_list_knowledge_agents()'
```
Returns:
```json
[
{"id": "08de66e8-...", "name": "Guru"},
{"id": "abc123...", "name": "Engineering Docs"}
]
```
Get AI-powered answers from a Knowledge Agent. Best for specific questions like "What is X?" or "How do I Y?".
```bash
mcporter call 'guru.guru_answer_generation(
agentId: "YOUR_AGENT_ID",
question: "How do I submit expenses?"
)'
```
Optional filters:
Returns comprehensive answer with sources.
Find documents, cards, and sources. Best for browsing content like "find docs on X" or "do we have cards about Y?".
```bash
mcporter call 'guru.guru_search_documents(
agentId: "YOUR_AGENT_ID",
query: "onboarding process"
)'
```
Returns list of matching documents with snippets.
Get full card content in HTML format.
```bash
mcporter call 'guru.guru_get_card_by_id(id: "CARD_ID")'
```
Returns card ID, title, and HTML content.
Create a new card draft.
```bash
mcporter call 'guru.guru_create_draft(
title: "New Process Guide",
content: "<h2>Overview</h2><p>This guide covers...</p>"
)'
```
Returns draft ID and URL.
Update an existing card. First retrieve current content with `guru_get_card_by_id`, then modify.
```bash
mcporter call 'guru.guru_update_card(
cardId: "CARD_ID",
title: "Updated Title",
content: "<p>Updated HTML content...</p>"
)'
```
**Important:** Preserve HTML structure when updating. Insert/replace content within existing DOM hierarchy.
```bash
mcporter call 'guru.guru_list_knowledge_agents()'
mcporter call 'guru.guru_answer_generation(
agentId: "08de66e8-...",
question: "What is the PTO policy?"
)'
```
```bash
mcporter call 'guru.guru_search_documents(
agentId: "08de66e8-...",
query: "expense report"
)'
mcporter call 'guru.guru_get_card_by_id(id: "CARD_ID_FROM_SEARCH")'
```
```bash
mcporter call 'guru.guru_create_draft(
title: "API Authentication Guide",
content: "<h2>Overview</h2><p>This guide explains how to authenticate with our API.</p><h2>Steps</h2><ol><li>Generate API key</li><li>Add to headers</li></ol>"
)'
```
| Use Case | Tool |
|----------|------|
| "What is X?" / "How do I Y?" | `guru_answer_generation` |
| "Find docs about X" | `guru_search_documents` |
| "Show me card XYZ" | `guru_get_card_by_id` |
| "Create a new guide for X" | `guru_create_draft` |
| "Update this card with..." | `guru_update_card` |
The `GURU_API_TOKEN` must be in format `email:token`:
```
[email protected]:a1b2c3d4-e5f6-7890-abcd-ef1234567890
```
Leave a review
No reviews yet. Be the first to review this skill!