Model Context Protocol (MCP) Server for Graphlit Platform

1[![npm version](https://badge.fury.io/js/graphlit-mcp-server.svg)](https://badge.fury.io/js/graphlit-mcp-server)
2[![smithery badge](https://smithery.ai/badge/@graphlit/graphlit-mcp-server)](https://smithery.ai/server/@graphlit/graphlit-mcp-server)
3 
4# Model Context Protocol (MCP) Server for Graphlit Platform
5 
6## Overview
7 
8The 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.
9 
10Ingest 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.
11 
12Your Graphlit project acts as a searchable, and RAG-ready knowledge base across all your developer and product management tools.
13 
14Documents (PDF, DOCX, PPTX, etc.) and HTML web pages will be extracted to Markdown upon ingestion. Audio and video files will be transcribed upon ingestion.
15 
16Web crawling and web search are built-in as MCP tools, with no need to integrate other tools like Firecrawl, Exa, etc. separately.
17 
18You can read more about the MCP Server use cases and features on our [blog](https://www.graphlit.com/blog/graphlit-mcp-server).
19 
20Watch our latest [YouTube video](https://www.youtube.com/watch?v=Or-QqonvcAs&t=4s) on using the Graphlit MCP Server with the Goose MCP client.
21 
22For any questions on using the MCP Server, please join our [Discord](https://discord.gg/ygFmfjy3Qx) community and post on the #mcp channel.
23 
24<a href="https://glama.ai/mcp/servers/fscrivteod">
25  <img width="380" height="200" src="https://glama.ai/mcp/servers/fscrivteod/badge" alt="graphlit-mcp-server MCP server" />
26</a>
27 
28## Tools
29 
30### Retrieval
31 
32- Query Contents
33- Query Collections
34- Query Feeds
35- Query Conversations
36- Retrieve Relevant Sources
37- Retrieve Similar Images
38- Visually Describe Image
39 
40### RAG
41 
42- Prompt LLM Conversation
43 
44### Extraction
45 
46- Extract Structured JSON from Text
47 
48### Publishing
49 
50- Publish as Audio (ElevenLabs Audio)
51- Publish as Image (OpenAI Image Generation)
52 
53### Ingestion
54 
55- Files
56- Web Pages
57- Messages
58- Posts
59- Emails
60- Issues
61- Text
62- Memory (Short-Term)
63 
64### Data Connectors
65 
66- Microsoft Outlook email
67- Google Mail
68- Notion
69- Reddit
70- Linear
71- Jira
72- GitHub Issues
73- Google Drive
74- OneDrive
75- SharePoint
76- Dropbox
77- Box
78- GitHub
79- Slack
80- Microsoft Teams
81- Discord
82- Twitter/X
83- Podcasts (RSS)
84 
85### Web
86 
87- Web Crawling
88- Web Search (including Podcast Search)
89- Web Mapping
90- Screenshot Page
91 
92### Notifications
93 
94- Slack
95- Email
96- Webhook
97- Twitter/X
98 
99### Operations
100 
101- Configure Project
102- Create Collection
103- Add Contents to Collection
104- Remove Contents from Collection
105- Delete Collection(s)
106- Delete Feed(s)
107- Delete Content(s)
108- Delete Conversation(s)
109- Is Feed Done?
110- Is Content Done?
111 
112### Enumerations
113 
114- List Slack Channels
115- List Microsoft Teams Teams
116- List Microsoft Teams Channels
117- List SharePoint Libraries
118- List SharePoint Folders
119- List Linear Projects
120- List Notion Databases
121- List Notion Pages
122- List Dropbox Folders
123- List Box Folders
124- List Discord Guilds
125- List Discord Channels
126- List Google Calendars
127- List Microsoft Calendars
128 
129## Resources
130 
131- Project
132- Contents
133- Feeds
134- Collections (of Content)
135- Workflows
136- Conversations
137- Specifications
138 
139## Prerequisites
140 
141Before you begin, ensure you have the following:
142 
143- Node.js installed on your system (recommended version 18.x or higher).
144- An active account on the [Graphlit Platform](https://portal.graphlit.dev) with access to the API settings dashboard.
145 
146## Configuration
147 
148The Graphlit MCP Server supports environment variables to be set for authentication and configuration:
149 
150- `GRAPHLIT_ENVIRONMENT_ID`: Your environment ID.
151- `GRAPHLIT_ORGANIZATION_ID`: Your organization ID.
152- `GRAPHLIT_JWT_SECRET`: Your JWT secret for signing the JWT token.
153 
154You can find these values in the API settings dashboard on the [Graphlit Platform](https://portal.graphlit.dev).
155 
156## Installation
157 
158### Installing via VS Code
159 
160For quick installation, use one of the one-click install buttons below:
161 
162[![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-NPM-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=graphlit&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22organization_id%22%2C%22description%22%3A%22Graphlit%20Organization%20ID%22%2C%22password%22%3Atrue%7D%2C%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22environment_id%22%2C%22description%22%3A%22Graphlit%20Environment%20ID%22%2C%22password%22%3Atrue%7D%2C%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22jwt_secret%22%2C%22description%22%3A%22Graphlit%20JWT%20Secret%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22graphlit-mcp-server%22%5D%2C%22env%22%3A%7B%22GRAPHLIT_ORGANIZATION_ID%22%3A%22%24%7Binput%3Aorganization_id%7D%22%2C%22GRAPHLIT_ENVIRONMENT_ID%22%3A%22%24%7Binput%3Aenvironment_id%7D%22%2C%22GRAPHLIT_JWT_SECRET%22%3A%22%24%7Binput%3Ajwt_secret%7D%22%7D%7D) [![Install with NPX in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-NPM-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=graphlit&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22organization_id%22%2C%22description%22%3A%22Graphlit%20Organization%20ID%22%2C%22password%22%3Atrue%7D%2C%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22environment_id%22%2C%22description%22%3A%22Graphlit%20Environment%20ID%22%2C%22password%22%3Atrue%7D%2C%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22jwt_secret%22%2C%22description%22%3A%22Graphlit%20JWT%20Secret%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22graphlit-mcp-server%22%5D%2C%22env%22%3A%7B%22GRAPHLIT_ORGANIZATION_ID%22%3A%22%24%7Binput%3Aorganization_id%7D%22%2C%22GRAPHLIT_ENVIRONMENT_ID%22%3A%22%24%7Binput%3Aenvironment_id%7D%22%2C%22GRAPHLIT_JWT_SECRET%22%3A%22%24%7Binput%3Ajwt_secret%7D%22%7D%7D&quality=insiders)
163 
164For 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)`.
165 
166Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others.
167 
168> Note that the `mcp` key is not needed in the `.vscode/mcp.json` file.
169 
170```json
171{
172  "mcp": {
173    "inputs": [
174      {
175        "type": "promptString",
176        "id": "organization_id",
177        "description": "Graphlit Organization ID",
178        "password": true
179      },
180      {
181        "type": "promptString",
182        "id": "environment_id",
183        "description": "Graphlit Environment ID",
184        "password": true
185      },
186      {
187        "type": "promptString",
188        "id": "jwt_secret",
189        "description": "Graphlit JWT Secret",
190        "password": true
191      }
192    ],
193    "servers": {
194      "graphlit": {
195        "command": "npx",
196        "args": ["-y", "graphlit-mcp-server"],
197        "env": {
198          "GRAPHLIT_ORGANIZATION_ID": "${input:organization_id}",
199          "GRAPHLIT_ENVIRONMENT_ID": "${input:environment_id}",
200          "GRAPHLIT_JWT_SECRET": "${input:jwt_secret}"
201        }
202      }
203    }
204  }
205}
206```
207 
208### Installing via Windsurf
209 
210To install graphlit-mcp-server in Windsurf IDE application, Cline should use NPX:
211 
212```bash
213npx -y graphlit-mcp-server
214```
215 
216Your mcp_config.json file should be configured similar to:
217 
218```
219{
220    "mcpServers": {
221        "graphlit-mcp-server": {
222            "command": "npx",
223            "args": [
224                "-y",
225                "graphlit-mcp-server"
226            ],
227            "env": {
228                "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
229                "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
230                "GRAPHLIT_JWT_SECRET": "your-jwt-secret",
231            }
232        }
233    }
234}
235```
236 
237### Installing via Cline
238 
239To install graphlit-mcp-server in Cline IDE application, Cline should use NPX:
240 
241```bash
242npx -y graphlit-mcp-server
243```
244 
245Your cline_mcp_settings.json file should be configured similar to:
246 
247```
248{
249    "mcpServers": {
250        "graphlit-mcp-server": {
251            "command": "npx",
252            "args": [
253                "-y",
254                "graphlit-mcp-server"
255            ],
256            "env": {
257                "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
258                "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
259                "GRAPHLIT_JWT_SECRET": "your-jwt-secret",
260            }
261        }
262    }
263}
264```
265 
266### Installing via Cursor
267 
268To install graphlit-mcp-server in Cursor IDE application, Cursor should use NPX:
269 
270```bash
271npx -y graphlit-mcp-server
272```
273 
274Your mcp.json file should be configured similar to:
275 
276```
277{
278    "mcpServers": {
279        "graphlit-mcp-server": {
280            "command": "npx",
281            "args": [
282                "-y",
283                "graphlit-mcp-server"
284            ],
285            "env": {
286                "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
287                "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
288                "GRAPHLIT_JWT_SECRET": "your-jwt-secret",
289            }
290        }
291    }
292}
293```
294 
295### Installing via Smithery
296 
297To install graphlit-mcp-server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@graphlit/graphlit-mcp-server):
298 
299```bash
300npx -y @smithery/cli install @graphlit/graphlit-mcp-server --client claude
301```
302 
303### Installing manually
304 
305To use the Graphlit MCP Server in any MCP client application, use:
306 
307```
308{
309    "mcpServers": {
310        "graphlit-mcp-server": {
311            "command": "npx",
312            "args": [
313                "-y",
314                "graphlit-mcp-server"
315            ],
316            "env": {
317                "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
318                "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
319                "GRAPHLIT_JWT_SECRET": "your-jwt-secret",
320            }
321        }
322    }
323}
324```
325 
326Optionally, you can configure the credentials for data connectors, such as Slack, Google Email and Notion.
327Only GRAPHLIT_ORGANIZATION_ID, GRAPHLIT_ENVIRONMENT_ID and GRAPHLIT_JWT_SECRET are required.
328 
329```
330{
331    "mcpServers": {
332        "graphlit-mcp-server": {
333            "command": "npx",
334            "args": [
335                "-y",
336                "graphlit-mcp-server"
337            ],
338            "env": {
339                "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
340                "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
341                "GRAPHLIT_JWT_SECRET": "your-jwt-secret",
342                "SLACK_BOT_TOKEN": "your-slack-bot-token",
343                "DISCORD_BOT_TOKEN": "your-discord-bot-token",
344                "TWITTER_TOKEN": "your-twitter-token",
345                "GOOGLE_EMAIL_REFRESH_TOKEN": "your-google-refresh-token",
346                "GOOGLE_EMAIL_CLIENT_ID": "your-google-client-id",
347                "GOOGLE_EMAIL_CLIENT_SECRET": "your-google-client-secret",
348                "LINEAR_API_KEY": "your-linear-api-key",
349                "GITHUB_PERSONAL_ACCESS_TOKEN": "your-github-pat",
350                "JIRA_EMAIL": "your-jira-email",
351                "JIRA_TOKEN": "your-jira-token",
352                "NOTION_API_KEY": "your-notion-api-key"
353            }
354        }
355    }
356}
357```
358 
359NOTE: when running 'npx' on Windows, you may need to explicitly call npx via the command prompt.
360 
361```
362"command": "C:\\Windows\\System32\\cmd.exe /c npx"
363```
364 
365## Support
366 
367Please refer to the [Graphlit API Documentation](https://docs.graphlit.dev/).
368 
369For support with the Graphlit MCP Server, please submit a [GitHub Issue](https://github.com/graphlit/graphlit-mcp-server/issues).
370 
371For further support with the Graphlit Platform, please join our [Discord](https://discord.gg/ygFmfjy3Qx) community.
372