← Back to directory
G

Graphlit MCP Server

Community
Seamlessly integrate Graphlit platform with MCP clients for content ingestion, search, and RAG knowledge bases.
Category
Other #30 of 230
Stars
★ 378 Popular
Transport
stdio (local process)
Runtime
Node.js 18+
Credentials
API key / credential required
License
MIT
Last commit
⚠
Tools
59
66FMRS · C

The Graphlit MCP server is a feature-rich tool for integrating the Graphlit platform into MCP clients, offering extensive data ingestion, search, and RAG capabilities. It is well-suited for teams needing to centralize multiple data sources and leverage LLMs for querying. However, it relies on the paid Graphlit service and requires configuration of multiple credentials. For non-developers or those not needing complex knowledge management, it may be overly complex.

Strongest · Maintenance 16/20 Weakest · Reliability 8/20

Reliability
8/20
Security and permissions
13/20
Maintenance
16/20
Documentation
15/20
Setup experience
14/20
Why each score
Reliability 8/20
Evidence: The server runs via npx and exports an MCP server object over stdio in src/index.js; the repo has GitHub Actions CI (npm test on Node 16/18/20) and an mcp-inspector workflow. Many Graphlit operations are wrapped as tools with a detailed declared tool list. Deductions: No committed tests exercise the actual MCP handshake or tool behaviors; tool inputs are mostly loose JSON values with no local validation, and runtime correctness depends on the remote Graphlit API; the README is the only operational evidence, so real tool behavior cannot be confirmed.
Security and permissions 13/20
Evidence: Credentials (GRAPHLIT_ORGANIZATION_ID, GRAPHLIT_ENVIRONMENT_ID, GRAPHLIT_JWT_SECRET, optional connector tokens) are provided only via environment variables; the code calls Graphlit through the @graphlit/client SDK, and nothing suggests token logging or exfiltration; README examples use placeholders only. Deductions: The toolset includes many irreversible/side-effect operations (delete contents/collections/feeds/conversations, publish audio/images, triggers, crawling/search/screenshots), all exposed without client confirmation or per-tool scope; no explicit least-privilege guidance or security policy is present; dependency audit evidence is absent.
Maintenance 16/20
Evidence: MIT license; repository is active with ~379 stars and only 5 open issues; package.json shows version 1.0.53 and an npm badge implies continuing releases; GitHub Actions CI on Node 16/18/20 and an mcp-inspector workflow exist; README points to docs, Discord, and GitHub Issues for support. Deductions: No SECURITY.md or dedicated security-response channel; release cadence and dependency update history cannot be verified from the static files; issue closure responsiveness is not evidenced.
Documentation 15/20
Evidence: README is well-structured with overview, tool categories, prerequisites, install examples for VS Code/Windsurf/Cline/Cursor/Smithery, manual config, optional connector environment variables, and support channels; blog, YouTube, and Glama badge links are included. Deductions: No per-tool parameter schemas or detailed tool documentation; no quota/cost/rate-limit disclosure; troubleshooting section is missing; documentation rests entirely on README claims without verifiable API reference.
Setup experience 14/20
Evidence: The setup path is short and clear: run via npx -y graphlit-mcp-server; README gives concrete JSON config examples for VS Code, Windsurf, Cline, Cursor, Smithery, and manual clients; only three core env vars are required, with optional connector examples; Windows cmd /c npx workaround is documented. Deductions: No execution verification in this review; obtaining credentials requires a Graphlit platform account and manual dashboard copy, which is mentioned but not detailed; no troubleshooting for first-run npx/network issues; static constraint limits the score to 15 or below.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the networkChanges third-party account data

Best for

  • Developers and managers who want to consolidate multiple data sources into a searchable knowledge base.
  • Teams that need to extract information from unstructured documents for LLM-powered applications.
  • Users already using the Graphlit platform or interested in trying it.

Not for

  • Users who only need simple web search or do not require data persistence.
  • Users who need local storage or open-source solutions, as Graphlit is a hosted cloud platform.
  • Users requiring fully offline or private deployment.

Required permissions

  • Requires Graphlit Environment ID, Organization ID, and JWT secret for authentication.
  • Optional: Data connector tokens such as Slack Bot Token, Discord Bot Token, Google OAuth credentials, etc., to access external services.
  • MCP clients need to execute npx commands, requiring network access and a Node.js environment.

Risks and side effects

  • Data security: Connectors access external services; ensure permissions are scoped minimally.
  • Cost: Graphlit is a paid service; improper use may incur charges.
  • Credential leakage: Environment variables contain sensitive info; guard them carefully, especially in shared configs.
  • Third-party dependencies: The server is fetched via npx, introducing potential supply chain risks.

Setup

Before you start

Runtime:Node.js 18+

GRAPHLIT_ORGANIZATION_ID required Your Graphlit organization ID, found in the API settings dashboard on the Graphlit Platform (portal.graphlit.dev).
GRAPHLIT_ENVIRONMENT_ID required Your Graphlit environment ID, found in the API settings dashboard on the Graphlit Platform.
GRAPHLIT_JWT_SECRET requiredsecret JWT secret for signing the auth token, found in the API settings dashboard on the Graphlit Platform.
SLACK_BOT_TOKEN optionalsecret Optional Slack bot token for the Slack connector and notifications.
DISCORD_BOT_TOKEN optionalsecret Optional Discord bot token for the Discord connector.
TWITTER_TOKEN optionalsecret Optional Twitter/X token for the connector and notifications.
GOOGLE_EMAIL_REFRESH_TOKEN optionalsecret Optional Google refresh token for the Gmail connector.
GOOGLE_EMAIL_CLIENT_ID optionalsecret Optional Google OAuth client ID for the Gmail connector.
GOOGLE_EMAIL_CLIENT_SECRET optionalsecret Optional Google OAuth client secret for the Gmail connector.
LINEAR_API_KEY optionalsecret Optional Linear API key for the Linear connector.
GITHUB_PERSONAL_ACCESS_TOKEN optionalsecret Optional GitHub personal access token for the GitHub connector.
JIRA_TOKEN optionalsecret Optional Jira API token for the Jira connector.
NOTION_API_KEY optionalsecret Optional Notion API key for the Notion connector.
Other optional settings (1)
JIRA_EMAIL optional Optional Jira account email for the Jira connector.
  1. Ensure Node.js 18 or higher is installed.
  2. Add the server to your MCP client configuration using the command npx -y graphlit-mcp-server and set the environment variables GRAPHLIT_ORGANIZATION_ID, GRAPHLIT_ENVIRONMENT_ID, and GRAPHLIT_JWT_SECRET.
  3. Optionally, configure credentials for data connectors like Slack, Google Email, and Notion.
  4. Start the client; the server will connect automatically.
claude_desktop_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"
      }
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json
{
  "servers": {
    "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"
      }
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add graphlit-mcp-server -e GRAPHLIT_ORGANIZATION_ID=your-organization-id -e GRAPHLIT_ENVIRONMENT_ID=your-environment-id -e GRAPHLIT_JWT_SECRET=your-jwt-secret -- npx -y graphlit-mcp-server

Run it in a terminal; replace any <…> placeholders with your own values first.

Check that it works

Confirm that graphlit-mcp-server tools such as Query Contents, Web Search, and Ingest Web Page appear in your client's tool list; running a Web Search query that returns results proves the connection works.

Troubleshooting

  1. If connection fails, verify environment variables, especially GRAPHLIT_JWT_SECRET.
  2. Ensure Node.js version is at least 18 and that `npx` executes correctly.
  3. On Windows, you might need to prefix `cmd /c` to the command.
  4. If a specific data connector (e.g., Slack) fails, check that the corresponding token or OAuth credentials are valid and have necessary permissions.

Things to try

Once connected, you can ask your AI assistant things like:

  • Crawl and ingest this web page into my project: https://www.graphlit.com/blog, then summarize it.
  • Search my ingested GitHub issues for anything related to MCP.
  • Extract structured JSON from this text: ...
  • List the channels in my Slack workspace.

Tools 59

Query Contents read-only
Query contents in the project.
Query Collections read-only
Query collections of content.
Query Feeds read-only
Query feeds in the project.
Query Conversations read-only
Query conversations in the project.
Retrieve Relevant Sources read-only
Retrieve sources relevant to a query.
Retrieve Similar Images read-only
Retrieve images similar to a given image.
Visually Describe Image read-only
Describe an image visually.
Prompt LLM Conversation read-only
Prompt an LLM conversation for RAG.
Show 51 more tools
Extract Structured JSON from Text read-only
Extract structured JSON from text.
Publish as Audio writes
Publish content as audio using ElevenLabs.
Publish as Image writes
Publish content as an image using OpenAI.
Ingest File writes
Ingest a file into the project.
Ingest Web Page writes
Ingest a web page into the project.
Ingest Message writes
Ingest a message (e.g., Slack, Teams) into the project.
Ingest Post writes
Ingest a post (e.g., Discord, Reddit) into the project.
Ingest Email writes
Ingest an email into the project.
Ingest Issue writes
Ingest an issue (e.g., Jira, GitHub) into the project.
Ingest Text writes
Ingest text content into the project.
Ingest Memory writes
Ingest short-term memory data.
Ingest from Slack writes
Ingest data from Slack.
Ingest from Discord writes
Ingest data from Discord.
Ingest from Website writes
Ingest data from a website.
Ingest from Google Drive writes
Ingest data from Google Drive.
Ingest from Email writes
Ingest data from email.
Ingest from Jira writes
Ingest data from Jira.
Ingest from Linear writes
Ingest data from Linear.
Ingest from GitHub writes
Ingest data from GitHub.
Web Crawling read-only
Crawl websites.
Web Search read-only
Perform web search (including podcast search).
Web Mapping read-only
Map website structure.
Screenshot Page read-only
Take a screenshot of a web page.
Notify via Slack destructive
Send notifications via Slack.
Notify via Email destructive
Send notifications via email.
Notify via Webhook destructive
Send notifications via webhook.
Notify via Twitter/X destructive
Send notifications via Twitter/X.
Configure Project writes
Configure project settings.
Create Collection writes
Create a collection of content.
Add Contents to Collection writes
Add contents to a collection.
Remove Contents from Collection writes
Remove contents from a collection.
Delete Collections destructive
Delete one or more collections.
Delete Feeds destructive
Delete one or more feeds.
Delete Contents destructive
Delete one or more contents.
Delete Conversations destructive
Delete one or more conversations.
Is Feed Done? read-only
Check if a feed has finished ingestion.
Is Content Done? read-only
Check if content has finished processing.
List Slack Channels read-only
List Slack channels.
List Microsoft Teams Teams read-only
List Microsoft Teams teams.
List Microsoft Teams Channels read-only
List Microsoft Teams channels.
List SharePoint Libraries read-only
List SharePoint libraries.
List SharePoint Folders read-only
List SharePoint folders.
List Linear Projects read-only
List Linear projects.
List Notion Databases read-only
List Notion databases.
List Notion Pages read-only
List Notion pages.
List Dropbox Folders read-only
List Dropbox folders.
List Box Folders read-only
List Box folders.
List Discord Guilds read-only
List Discord guilds.
List Discord Channels read-only
List Discord channels.
List Google Calendars read-only
List Google calendars.
List Microsoft Calendars read-only
List Microsoft calendars.

Use cases

Ingest and search project documents, web pages, and code repositories directly from an IDE.
Build a unified knowledge base across Slack, Discord, GitHub, and other tools.
Perform RAG via natural language queries without switching contexts.
Automate content ingestion workflows such as web crawling and document processing.

Supported clients

Claude Desktop
Cursor
Windsurf
Goose
Cline

Listed from the project's documentation, not tested by this site.

Overview

The Graphlit MCP Server enables integration between MCP clients (like Cursor, Windsurf, Goose, or Cline) and the Graphlit service. You can ingest content from Slack, Discord, websites, Google Drive, email, Jira, Linear, or GitHub, and then search and retrieve relevant knowledge within the client. Documents (PDF, DOCX, PPTX, etc.) and HTML web pages are extracted to Markdown upon ingestion, and audio/video files are transcribed. Web crawling and web search are built-in, eliminating the need for separate tools. Your Graphlit project serves as a searchable, RAG-ready knowledge base across all your developer and product management tools.

Similar servers

BioMCP 75 · B

One binary. One grammar. Evidence from the biomedical sources you already trust.

★ 659 · Tools 11 Compare with this →

Source revision 1b94b887ba16 Data synced 2026-10-19 Read the FMRS scoring method