Skip to content
guru-mcp logo

Guru MCP

guru-mcp

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.

SKILL.md

Full skill instructions

Guru MCP

Access your Guru knowledge base via the official MCP server. Ask AI-powered questions, search documents, create drafts, and update cards.

Features

  • AI-Powered Answers — Get comprehensive answers from Knowledge Agents
  • Document Search — Find cards and content across your knowledge base
  • Create Drafts — Generate new card drafts from AI tools
  • Update Cards — Modify existing cards directly
  • Connected Sources — Access Salesforce, Slack, Google Drive, Confluence, SharePoint through Guru
  • Permission-Aware — Respects all existing Guru permissions
  • Analytics — All queries logged in AI Agent Center

Setup

1. Get API Token

  1. Go to Guru Admin → API Tokens
  2. Create a new token
  3. Note your email and token

2. Configure Environment

Add to ~/​.clawdbot/​.env:

[email protected]:your-api-token

3. Configure mcporter

Add to config/​mcporter.json:

{
  "mcpServers": {
    "guru": {
      "baseUrl": "https://mcp.api.getguru.com/​mcp",
      "headers": {
        "Authorization": "Bearer ${GURU_API_TOKEN}"
      }
    }
  }
}

4. Verify

mcporter list guru

Available Tools

guru_list_knowledge_agents

List all Knowledge Agents in your workspace. Always call this first to get agent IDs for other tools.

mcporter call 'guru.guru_list_knowledge_agents()'

Returns:

[
  {"id": "08de66e8-...", "name": "Guru"},
  {"id": "abc123...", "name": "Engineering Docs"}
]

guru_answer_generation

Get AI-powered answers from a Knowledge Agent. Best for specific questions like "What is X?" or "How do I Y?".

mcporter call 'guru.guru_answer_generation(
  agentId: "YOUR_AGENT_ID",
  question: "How do I submit expenses?"
)'

Optional filters:

  • collectionIds — Limit to specific collections
  • sourceIds — Limit to specific sources

Returns comprehensive answer with sources.

guru_search_documents

Find documents, cards, and sources. Best for browsing content like "find docs on X" or "do we have cards about Y?".

mcporter call 'guru.guru_search_documents(
  agentId: "YOUR_AGENT_ID",
  query: "onboarding process"
)'

Returns list of matching documents with snippets.

guru_get_card_by_id

Get full card content in HTML format.

mcporter call 'guru.guru_get_card_by_id(id: "CARD_ID")'

Returns card ID, title, and HTML content.

guru_create_draft

Create a new card draft.

mcporter call 'guru.guru_create_draft(
  title: "New Process Guide",
  content: "<h2>Overview</​h2><p>This guide covers...</​p>"
)'

Returns draft ID and URL.

guru_update_card

Update an existing card. First retrieve current content with guru_get_card_by_id, then modify.

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.

Usage Patterns

Ask a Question

# 1. Get agent ID
mcporter call 'guru.guru_list_knowledge_agents()'

# 2. Ask question
mcporter call 'guru.guru_answer_generation(
  agentId: "08de66e8-...",
  question: "What is the PTO policy?"
)'

Find and Read a Card

# 1. Search for cards
mcporter call 'guru.guru_search_documents(
  agentId: "08de66e8-...",
  query: "expense report"
)'

# 2. Get full content
mcporter call 'guru.guru_get_card_by_id(id: "CARD_ID_FROM_SEARCH")'

Create New Documentation

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>"
)'

Choosing the Right Tool

Use CaseTool
"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

Token Format

The GURU_API_TOKEN must be in format email:token:

[email protected]:a1b2c3d4-e5f6-7890-abcd-ef1234567890

Notes

  • Questions appear in Guru's AI Agent Center analytics
  • All permissions enforced (users only see what they have access to)
  • Knowledge Agents can be domain-specific — choose the right one for your question
  • Card content is HTML — preserve structure when updating

Resources

More Sales & marketing skills

revops logo
Sales & marketing

revops

Design and optimize systems connecting marketing, sales, and customer success into a unified revenue engine.

53.3K 104.9K
View
lead-magnets logo
Sales & marketing

lead-magnets

Strategic planning and optimization for email capture offers and gated content.

53.3K 103.4K
View
directory-submissions logo
Sales & marketing

directory-submissions

Directory submissions: the foundation layer of distribution that passes backlinks and discovery surface area into your marketing pages.

53.3K 76.3K
View
gsap-timeline logo
Sales & marketing

gsap-timeline

Sequence and choreograph multi-step animations with precise timing control and nested timelines.

15.9K 58.4K
View
launch-strategy logo
Sales & marketing

launch-strategy

Structured framework for planning product launches, feature announcements, and go-to-market strategies.

53.3K 56.8K
View
gws-drive-upload logo
Sales & marketing

gws-drive-upload

Upload files to Google Drive with automatic MIME type detection and metadata.

31.2K 47.2K
View
ci-cd-and-automation logo
Sales & marketing

ci-cd-and-automation

Automates CI/CD pipeline setup. Use when setting up or modifying build and deployment pipelines. Use when you need to automate quality gates, configure test runners in CI, or establish deployment strategies.

101.4K 43.2K
View
persona-team-lead logo
Sales & marketing

persona-team-lead

Team leadership persona with standup coordination, meeting prep, task delegation, and team communication.

31.2K 29.3K
View
recipe-find-large-files logo
Sales & marketing

recipe-find-large-files

Identify large Google Drive files consuming storage quota.

31.2K 29.2K
View

Sales & marketing AI tools

KreadoAI logo
Sales & marketing

KreadoAI

Revolutionize Video Creation with AI-Generated Avatars and Voices

Paid
View
Followr logo
Sales & marketing

Followr

Social media on autopilot

Paid
View
Logodiffusion logo
Sales & marketing

Logodiffusion

Design custom logos instantly with AI.

Paid
View
I
Sales & marketing

Ideogram

Text-heavy marketing and design images

Freemium
View
Prompt Silo logo
Sales & marketing

Prompt Silo

Boost Your SEO with Content and SEO Silos

Free
View
Marketing Blocks logo
Sales & marketing

Marketing Blocks

Revolutionize Your Marketing with AI-Powered MarketingBlocks!

Paid
View
Scrip AI logo
Sales & marketing

Scrip AI

10X faster & free AI content creation for 100+ use cases

Free
View
Tribescaler logo
Sales & marketing

Tribescaler

Tribescaler | Make Your Tweets Go Viral

Paid
View