by graphlit
Enables integration between MCP clients and the Graphlit platform, providing ingestion, extraction, retrieval, and RAG capabilities across a wide range of data sources and connectors.
Graphlit MCP Server acts as a bridge that allows MCP‑compatible clients (e.g., Cursor, Windsurf, Goose, Cline) to interact with the Graphlit knowledge base. It centralizes ingestion of unstructured data, performs content extraction, supports search and retrieval, and powers retrieval‑augmented generation (RAG) workflows.
npx -y graphlit-mcp-server
Q: Which Node.js version is required? A: Node 18.x or higher.
Q: Do I need to install any additional tools for web crawling? A: No – crawling is built into the MCP server.
Q: How are authentication tokens handled?
A: Provide GRAPHLIT_ORGANIZATION_ID
, GRAPHLIT_ENVIRONMENT_ID
, and GRAPHLIT_JWT_SECRET
as environment variables; the server signs JWTs for client connections.
Q: Can I use the server on Windows?
A: Yes. If npx
fails, invoke it via cmd.exe /c npx
as shown in the README.
Q: Where can I get help? A: Open a GitHub issue, consult the Graphlit API docs, or join the Graphlit Discord community.
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.
Before you begin, ensure you have the following:
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.
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}"
}
}
}
}
}
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",
}
}
}
}
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",
}
}
}
}
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",
}
}
}
}
To install graphlit-mcp-server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @graphlit/graphlit-mcp-server --client claude
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"
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.
Please log in to share your review and rating for this MCP.
{ "mcpServers": { "graphlit": { "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>" } } } }
Explore related MCPs that share similar capabilities and solve comparable challenges
by exa-labs
Provides real-time web search capabilities to AI assistants via a Model Context Protocol server, enabling safe and controlled access to the Exa AI Search API.
by elastic
Enables natural‑language interaction with Elasticsearch indices via the Model Context Protocol, exposing tools for listing indices, fetching mappings, performing searches, running ES|QL queries, and retrieving shard information.
by mamertofabian
Fast cross‑platform file searching leveraging the Everything SDK on Windows, Spotlight on macOS, and locate/plocate on Linux.
by cr7258
Provides Elasticsearch and OpenSearch interaction via Model Context Protocol, enabling document search, index management, cluster monitoring, and alias operations.
by liuyoshio
Provides natural‑language search and recommendation for Model Context Protocol servers, delivering rich metadata and real‑time updates.
by ihor-sokoliuk
Provides web search capabilities via the SearXNG API, exposing them through an MCP server for seamless integration with AI agents and tools.
by fatwang2
Provides web and news search, URL crawling, sitemap extraction, deep‑reasoning, and trending topic retrieval via Search1API, exposed as an MCP server for integration with AI clients.
by cnych
Provides SEO data retrieval via Ahrefs, exposing MCP tools for backlink analysis, keyword generation, traffic estimation, and keyword difficulty, with automated CAPTCHA solving and response caching.
by nacos-group
Provides search, installation, and proxy functionalities for MCP servers, combining Nacos service discovery with optional Compass API support and offering both router and proxy operating modes.