Model Context Protocol (MCP) Server for Graphlit Platform

Overview

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. This document outlines the setup process and provides a basic example of using the client.

Ingest anything from Slack, Discord, websites, Google Drive, email, Jira, Linear or GitHub into a Graphlit project - and then search and retrieve relevant knowledge within an MCP client like Cursor, Windsurf, Goose or Cline.

Documents (PDF, DOCX, PPTX, etc.) and HTML web pages will be extracted to Markdown upon ingestion.

Audio and video files will be transcribed upon ingestion.

Web crawling and web search are built-in as MCP tools, with no need to integrate other tools like Firecrawl, Exa, etc. separately.

You can read more about the MCP Server use cases and features on our blog.

For any questions on using the MCP Server, please join our Discord community and post on the #mcp channel.

Tools

Retrieval

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

Extraction

Extract Structured JSON from Text

Ingestion

Files
Web Pages
Messages
Posts
Emails
Issues
Text

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)
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
Specifications

Prerequisites

Before you begin, ensure you have the following:

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

Configuration

The Graphlit MCP Server supports environment variables to be set 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.

You can find these values in the API settings dashboard on the Graphlit Platform.

Installation

Installing via VS Code

For quick installation, use one of the one-click install buttons below:

For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P and typing Preferences: Open User Settings (JSON).

Optionally, you can add it to a file called .vscode/mcp.json in your workspace. This will allow you to share the configuration with others.

Note that the mcp key is not needed in the .vscode/mcp.json file.

{
  "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

To install graphlit-mcp-server in Windsurf IDE application, Cline should use NPX:

npx -y graphlit-mcp-server

Your mcp_config.json file should be configured similar to:

{
    "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

To install graphlit-mcp-server in Cline IDE application, Cline should use NPX:

npx -y graphlit-mcp-server

Your cline_mcp_settings.json file should be configured similar to:

{
    "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

To install graphlit-mcp-server in Cursor IDE application, Cline should use NPX:

npx -y graphlit-mcp-server

Your mcp.json file should be configured similar to:

{
    "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

To install graphlit-mcp-server for Claude Desktop automatically via Smithery:

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

Installing manually

To use the Graphlit MCP Server in any MCP client application, use:

{
    "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, you can configure the credentials for data connectors, such as Slack, Google Email and Notion.Only GRAPHLIT_ORGANIZATION_ID, GRAPHLIT_ENVIRONMENT_ID and GRAPHLIT_JWT_SECRET are required.

{
    "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

Please refer to the Graphlit API Documentation.

For support with the Graphlit MCP Server, please submit a GitHub Issue.

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

Model Context Protocol (MCP) Server for Graphlit Platform