guru

This MCP server provides a set of Guru-related tools via the Stdio-based MCP framework. It wraps the Guru REST API to enable programmatic management of Guru knowledge base cards, including listing, reading, creating, updating, deleting, and verifying cards, as well as listing groups and assigning verifiers. With the provided tools, you can search cards by verification status, collection, verifier, and terms; fetch full content and metadata for a specific card; create and update cards in a chosen collection; delete cards; verify cards and reset their verification timers; list all groups in your Guru team; and assign a verifier to a card. The server exposes these capabilities through the MCP interface, allowing you to integrate Guru data into your workflow and automation pipelines. To use it, run the configured Node.js server and ensure your environment variables for Guru authentication are set as described in the setup, then interact with the tools via the MCP client in your project.

Prerequisites:

• Node.js and npm installed on your machine
• Git installed

Installation steps:

1. Clone the repository and install dependencies:

mkdir -p ~/mcp-servers
git clone git@github.com:InfuseGroup/guru-mcp-server.git ~/mcp-servers/guru
cd ~/mcp-servers/guru
npm install

2. Obtain Guru API credentials:

• Go to Guru > Settings > API Access
• Generate a User Token
• Note your Guru login email

3. Configure your MCP JSON entry (example):

{
  "mcpServers": {
    "guru": {
      "command": "node",
      "args": ["/Users/<you>/mcp-servers/guru/index.js"],
      "env": {
        "GURU_EMAIL": "your.email@example.com",
        "GURU_API_TOKEN": "your-api-token"
      }
    }
  }
}

4. Place the above configuration in your project’s .mcp.json and ensure credentials are kept out of version control (add .mcp.json to .gitignore). Restart Claude Code or your MCP runtime to pick up the new server configuration.

Tips and notes:

• The .mcp.json file contains credentials; keep it secured and add it to your .gitignore to prevent accidental commits.
• Environment variables required: GURU_EMAIL and GURU_API_TOKEN.
• If you change the Guru credentials, restart the MCP runtime to apply the new credentials.
• The tools require the Guru account permissions appropriate for the actions (read, create, update, delete, verify, etc.).
• If you modify the server path or environment, update the mcp.json accordingly.
• Basic Auth is used for Guru access, scoped to the authenticated user’s permissions.
• Ensure network access to Guru API endpoints from where you run the MCP server.