what is Graphlit MCP Server?

Graphlit MCP Server is a platform that enables integration between MCP clients and the Graphlit service. It allows users to ingest data from various sources like Slack, Gmail, podcasts, web content, and more into a searchable Graphlit project, creating a searchable and RAG-ready knowledge base across different tools and platforms.

How to use Graphlit MCP Server?

To use the Graphlit MCP Server, follow these steps:

1. Install Node.js 18.x or higher on your system.
2. Create an account on the Graphlit Platform and obtain your environment ID, organization ID, and JWT secret.
3. Install the MCP Server via the provided methods (VS Code, Windsurf, Cline, Cursor, Smithery, or manually).
4. Configure the server with the necessary environment variables and credentials.
5. Use MCP clients like Cursor, Windsurf, Goose, or Cline to connect to the Graphlit MCP Server and access the searchable knowledge base.

Key features of Graphlit MCP Server?

• Data Ingestion: Ingest data from various sources like Slack, Gmail, podcasts, web content, and more.
• Searchable Knowledge Base: Create a searchable knowledge base across different tools and platforms.
• RAG-Ready: Retrieve relevant knowledge within MCP clients for enhanced search and retrieval capabilities.
• Document and Web Page Extraction: Extract documents (PDF, DOCX, PPTX) and HTML web pages to Markdown.
• Audio and Video Transcription: Transcribe audio and video files upon ingestion.
• Web Crawling and Search: Built-in tools for web crawling and web search, including podcast search.
• Retrieval and Extraction Tools: Query contents, collections, feeds, conversations, retrieve relevant sources, extract structured JSON from text, and more.
• Publishing Tools: Publish content as audio or images.
• Data Connectors: Connect to various data sources like Microsoft Outlook, Google Mail, Notion, Reddit, Linear, Jira, GitHub, Slack, Microsoft Teams, Discord, Twitter/X, and more.
• Notifications: Receive notifications via Slack, email, webhooks, and Twitter/X.

Use cases of Graphlit MCP Server?

1. Centralized Knowledge Management: Ingest data from various sources into a single searchable knowledge base.
2. Enhanced Search and Retrieval: Use built-in RAG capabilities to retrieve relevant information within MCP clients.
3. Automated Data Processing: Extract and transcribe documents, web pages, audio, and video files for easier data analysis.
4. Cross-Platform Integration: Connect and manage data from multiple platforms like Slack, Gmail, Notion, GitHub, and more.
5. Custom Workflows: Create custom workflows for data ingestion, processing, and retrieval.

FAQ from Graphlit MCP Server?

• What is the Model Context Protocol (MCP)?

The MCP is a protocol that enables integration between MCP clients and services like Graphlit, allowing for enhanced data retrieval and processing capabilities.

• What is required to install and configure the Graphlit MCP Server?

You need Node.js 18.x or higher, a Graphlit account with API settings access, and the necessary environment variables (organization ID, environment ID, JWT secret).

• What tools and data connectors are supported?

The Graphlit MCP Server supports a wide range of data connectors, including Slack, Gmail, Notion, GitHub, and more, along with tools for retrieval, RAG, extraction, publishing, and notifications.

• How do I integrate the Graphlit MCP Server with MCP clients like Cursor or Windsurf?

After installing the server, configure it with the necessary environment variables and credentials, then connect to it using your preferred MCP client.

• Where can I find support and documentation?

Refer to the Graphlit API Documentation and the GitHub Issue page for support. Join the Discord community for further assistance.

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.

Your Graphlit project acts as a searchable, and RAG-ready knowledge base across all your developer and product management tools.

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.

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

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
• Query Conversations
• Retrieve Relevant Sources
• Retrieve Similar Images
• Visually Describe Image

RAG

• Prompt LLM Conversation

Extraction

• Extract Structured JSON from Text

Publishing

• Publish as Audio (ElevenLabs Audio)
• Publish as Image (OpenAI Image Generation)

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

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, Cursor 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"
            }
        }
    }
}

NOTE: when running 'npx' on Windows, you may need to explicitly call npx via the command prompt.

"command": "C:\\Windows\\System32\\cmd.exe /c npx"

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.