📌Overview

Purpose: The Model Context Protocol (MCP) Server facilitates seamless integration between MCP clients and the Graphlit service, enabling efficient knowledge retrieval and management from various sources.

Overview: The MCP Server allows users to ingest a wide range of content types—from documents to media files—into Graphlit projects, making it easy to search and access relevant information through various MCP clients like Cursor, Windsurf, or Cline. The server streamlines multitasking by supporting document conversion, transcription of audio and video, and web crawling capabilities without needing additional tools.

Key Features:

Data Ingestion: Supports multiple input formats including files (such as PDF and DOCX), web pages, text, and media, streamlining the retrieval of diverse content types into Graphlit projects.
Web Crawling and Search: Built-in tools for web crawling and searching eliminate the need for separate integrations, providing a comprehensive way to source online content.

Model Context Protocol (MCP) Server for Graphlit Platform

Overview

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. It allows ingesting data from Slack, Discord, websites, Google Drive, email, Jira, Linear, GitHub, and more into a Graphlit project, which acts as a searchable, RAG-ready knowledge base across developer and product management tools.

Documents (PDF, DOCX, PPTX, etc.) and HTML web pages are extracted to Markdown upon ingestion, while audio and video files are transcribed.

Web crawling and web search are built-in MCP tools, requiring no additional integrations.

Learn more about MCP Server use cases and features on our blog.

Watch our YouTube video on using the Graphlit MCP Server with the Goose MCP client.

For questions, join our Discord community and post in the #mcp channel.

Tools

Retrieval

Query Contents
Query Collections
Query Feeds
Query Conversations
Retrieve Relevant Sources
Retrieve Similar Images
Visually Describe Image

RAG

Prompt LLM Conversation

Extraction

Extract Structured JSON from Text

Ingestion

Files
Web Pages
Messages
Posts
Emails
Issues
Text
Memory (Short-Term)

Data Connectors

Microsoft Outlook email
Google Mail
Notion
Reddit
Linear
Jira
GitHub Issues
Google Drive
OneDrive
SharePoint
Dropbox
Box
GitHub
Slack
Microsoft Teams
Discord
Twitter/X
Podcasts (RSS)

Web

Web Crawling
Web Search (including Podcast Search)
Web Mapping
Screenshot Page

Notifications

Slack
Email
Webhook
Twitter/X

Operations

Configure Project
Create Collection
Add Contents to Collection
Remove Contents from Collection
Delete Collection(s)
Delete Feed(s)
Delete Content(s)
Delete Conversation(s)
Is Feed Done?
Is Content Done?

Enumerations

List Slack Channels
List Microsoft Teams Teams
List Microsoft Teams Channels
List SharePoint Libraries
List SharePoint Folders
List Linear Projects
List Notion Databases

Resources

Project
Contents
Feeds
Collections (of Content)
Workflows
Conversations
Specifications

Prerequisites

Node.js installed (recommended version 18.x or higher).
An active account on the Graphlit Platform with access to the API settings dashboard.

Configuration

Set these environment variables for authentication and configuration:

GRAPHLIT_ENVIRONMENT_ID: Your environment ID.
GRAPHLIT_ORGANIZATION_ID: Your organization ID.
GRAPHLIT_JWT_SECRET: Your JWT secret for signing the JWT token.

These values are available in the API settings dashboard on the Graphlit Platform.

Installation

Installing via VS Code

For quick installation, use the one-click install buttons in VS Code or VS Code Insiders.

Alternatively, add the following JSON block to your User Settings (JSON) file (Preferences: Open User Settings (JSON)) or .vscode/mcp.json in your workspace:

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "organization_id",
        "description": "Graphlit Organization ID",
        "password": true
      },
      {
        "type": "promptString",
        "id": "environment_id",
        "description": "Graphlit Environment ID",
        "password": true
      },
      {
        "type": "promptString",
        "id": "jwt_secret",
        "description": "Graphlit JWT Secret",
        "password": true
      }
    ],
    "servers": {
      "graphlit": {
        "command": "npx",
        "args": ["-y", "graphlit-mcp-server"],
        "env": {
          "GRAPHLIT_ORGANIZATION_ID": "${input:organization_id}",
          "GRAPHLIT_ENVIRONMENT_ID": "${input:environment_id}",
          "GRAPHLIT_JWT_SECRET": "${input:jwt_secret}"
        }
      }
    }
  }
}

Installing via Windsurf

Install graphlit-mcp-server in Windsurf IDE using NPX:

npx -y graphlit-mcp-server

Example mcp_config.json:

{
  "mcpServers": {
    "graphlit-mcp-server": {
      "command": "npx",
      "args": ["-y", "graphlit-mcp-server"],
      "env": {
        "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
        "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
        "GRAPHLIT_JWT_SECRET": "your-jwt-secret"
      }
    }
  }
}

Installing via Cline

Install graphlit-mcp-server in Cline IDE using NPX:

npx -y graphlit-mcp-server

Example cline_mcp_settings.json:

{
  "mcpServers": {
    "graphlit-mcp-server": {
      "command": "npx",
      "args": ["-y", "graphlit-mcp-server"],
      "env": {
        "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
        "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
        "GRAPHLIT_JWT_SECRET": "your-jwt-secret"
      }
    }
  }
}

Installing via Cursor

Install graphlit-mcp-server in Cursor IDE using NPX:

npx -y graphlit-mcp-server

Example mcp.json:

{
  "mcpServers": {
    "graphlit-mcp-server": {
      "command": "npx",
      "args": ["-y", "graphlit-mcp-server"],
      "env": {
        "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
        "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
        "GRAPHLIT_JWT_SECRET": "your-jwt-secret"
      }
    }
  }
}

Installing via Smithery

Automatically install graphlit-mcp-server for Claude Desktop via Smithery:

npx -y @smithery/cli install @graphlit/graphlit-mcp-server --client claude

Manual Installation

Use the following configuration in any MCP client application:

{
  "mcpServers": {
    "graphlit-mcp-server": {
      "command": "npx",
      "args": ["-y", "graphlit-mcp-server"],
      "env": {
        "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
        "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
        "GRAPHLIT_JWT_SECRET": "your-jwt-secret"
      }
    }
  }
}

Optionally configure credentials for data connectors (Slack, Google Email, Notion, etc.) by setting corresponding environment variables. Only the three core variables are required.

Example:

{
  "mcpServers": {
    "graphlit-mcp-server": {
      "command": "npx",
      "args": ["-y", "graphlit-mcp-server"],
      "env": {
        "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
        "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
        "GRAPHLIT_JWT_SECRET": "your-jwt-secret",
        "SLACK_BOT_TOKEN": "your-slack-bot-token",
        "DISCORD_BOT_TOKEN": "your-discord-bot-token",
        "TWITTER_TOKEN": "your-twitter-token",
        "GOOGLE_EMAIL_REFRESH_TOKEN": "your-google-refresh-token",
        "GOOGLE_EMAIL_CLIENT_ID": "your-google-client-id",
        "GOOGLE_EMAIL_CLIENT_SECRET": "your-google-client-secret",
        "LINEAR_API_KEY": "your-linear-api-key",
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-github-pat",
        "JIRA_EMAIL": "your-jira-email",
        "JIRA_TOKEN": "your-jira-token",
        "NOTION_API_KEY": "your-notion-api-key"
      }
    }
  }
}

Support

Refer to the Graphlit API Documentation.

For Graphlit MCP Server support, submit a GitHub Issue.

For further assistance with the Graphlit Platform, join our Discord community.