Skip to content
Back to search

graphlit-mcp-server

Model Context Protocol (MCP) Server for Graphlit Platform

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/graphlit--graphlit-mcp-server/badge.svg)](/listings/graphlit--graphlit-mcp-server)

HTML

<a href="/listings/graphlit--graphlit-mcp-server"><img src="/api/listings/graphlit--graphlit-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 371 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

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

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.