https://github.com/graphlit/graphlit-mcp-server

Model Context Protocol (MCP) Server for Graphlit Platform
https://github.com/graphlit/graphlit-mcp-server

claude content-extraction content-ingestion data-collection llm-tools mcp-server model-context-protocol search-api unstructured-data web-crawler web-scraping

Last synced: 3 months ago
JSON representation

Model Context Protocol (MCP) Server for Graphlit Platform

• Host: GitHub
• URL: https://github.com/graphlit/graphlit-mcp-server
• Owner: graphlit
• License: mit
• Created: 2025-03-01T08:02:03.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2025-03-17T04:03:23.000Z (3 months ago)
• Last Synced: 2025-03-17T04:23:31.731Z (3 months ago)
• Topics: claude, content-extraction, content-ingestion, data-collection, llm-tools, mcp-server, model-context-protocol, search-api, unstructured-data, web-crawler, web-scraping
• Language: TypeScript
• Homepage: https://www.graphlit.com
• Size: 500 KB
• Stars: 58
• Watchers: 1
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-mcp-zh - Graphlit
• awesome-mcp-list - graphlit/graphlit-mcp-server - mcp-server?style=social)](https://github.com/graphlit/graphlit-mcp-server): Ingests data from various sources into a Graphlit project for searching and retrieval. (Uncategorized / Uncategorized)
• awesome-mcp-servers - graphlit-mcp-server - Ingest anything from Slack, Discord, websites, Google Drive, Linear or GitHub into a Graphlit project - and then search and retrieve relevant knowledge within an MCP client like Cursor, Windsurf or Cline. (Legend / 🧠 <a name="knowledge--memory"></a>Knowledge & Memory)
• awesome-mcp-servers - graphlit-mcp-server - Ingest anything from Slack, Discord, websites, Google Drive, Linear or GitHub into a Graphlit project - and then search and retrieve relevant knowledge within an MCP client like Cursor, Windsurf or Cline. (Legend / 🧠 <a name="knowledge--memory"></a>Knowledge & Memory)
• Awesome-MCP-Servers-directory - Graphlit - Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a searchable Graphlit project (Search)
• mcp-index - Graphlit - Integrate various data sources such as Slack, Gmail, and web feeds into Graphlit projects, enabling efficient retrieval and searching of relevant content via MCP clients. (Task and Project Management)
• awesome-mcp-servers - Graphlit MCP Server - Model Context Protocol (MCP) Server for Graphlit Platform (Table of Contents / Other Tools and Integrations)
• awesome-mcp-servers - Graphlit MCP Server - Model Context Protocol (MCP) Server for Graphlit Platform (Table of Contents / Other Tools and Integrations)
• awesome-mcp-servers - Graphlit - Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a searchable [Graphlit](https://www.graphlit.com) project. (Official Servers)

README

        
[![npm version](https://badge.fury.io/js/graphlit-mcp-server.svg)](https://badge.fury.io/js/graphlit-mcp-server)

[![smithery badge](https://smithery.ai/badge/@graphlit/graphlit-mcp-server)](https://smithery.ai/server/@graphlit/graphlit-mcp-server)

# 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 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 available as MCP tools, with no need to integrate Firecrawl, Exa, etc. separately.

You can read more about the MCP Server use cases and features on our [blog](https://www.graphlit.com/blog/graphlit-mcp-server).



  



## Tools

### Retrieval

- Query Contents

- Query Collections

- Retrieve Relevant Sources

- Retrieve Similar Images

- Visually Describe Image

### Extraction

- Extract Structured JSON from Text

### Ingestion

- Files

- Web Pages

- 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

- Podcasts (RSS)

### Web

- Web Crawling

- Web Search (including Podcast Search)

- Web Mapping

- Screenshot Page

### Notifications

- Slack

- Email

- Webhook

### Operations

- Configure Project

- Create Collection

- Add Contents to Collection

- Remove Contents from Collection

- Delete Collection

- 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

## 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](https://portal.graphlit.dev) with access to the API settings dashboard.

## Installation

### Installing via Windsurf

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

```bash

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:

```bash

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:

```bash

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](https://smithery.ai/server/@graphlit/graphlit-mcp-server):

```bash

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

```

### Installing manually for Claude Desktop

To use the Graphlit MCP Server in Claude Desktop 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.

```

{

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

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

                "NOTION_DATABASE_ID": "your-notion-database-id"

            }

        }

    }

}

```

### Installing manually via terminal

To install the Graphlit MCP Server, use npx:

```bash

npx install graphlit-mcp-server

```

## 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](https://portal.graphlit.dev).

## Support

Please refer to the [Graphlit API Documentation](https://docs.graphlit.dev/).

For support with the Graphlit MCP Server, please submit a [GitHub Issue](https://github.com/graphlit/graphlit-mcp-server/issues).  

For further support with the Graphlit Platform, please join our [Discord](https://discord.gg/ygFmfjy3Qx) community.