graphlit-mcp-serverOfficial Featured
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
graphlit
Tools
retrieveSources
Retrieve relevant content sources from Graphlit knowledge base. Do *not* use for retrieving content by content identifier - retrieve content resource instead, with URI 'contents://{id}'. Accepts a search prompt, optional recency filter (defaults to all time), and optional content type and file type filters. Also accepts optional feed and collection identifiers to filter content by. Prompt should be optimized for vector search, via text embeddings. Rewrite prompt as appropriate for higher relevance to search results. Returns the ranked content sources, including their content resource URI to retrieve the complete Markdown text.
extractText
Extracts JSON data from text using LLM. Accepts text to be extracted, and JSON schema which describes the data which will be extracted. JSON schema needs be of type 'object' and include 'properties' and 'required' fields. Optionally accepts text prompt which is provided to LLM to guide data extraction. Defaults to 'Extract data using the tools provided'. Returns extracted JSON from text.
createCollection
Create a collection. Accepts a collection name, and optional list of content identifiers to add to collection. Returns the collection identifier
addContentsToCollection
Add contents to a collection. Accepts a collection identifier and a list of content identifiers to add to collection. Returns the collection identifier.
removeContentsFromCollection
Remove contents from collection. Accepts a collection identifier and a list of content identifiers to remove from collection. Returns the collection identifier.
deleteCollection
Delete a collection. Does *not* delete the content in the collection. Accepts a collection identifier. Returns the collection identifier and collection state, i.e. Deleted.
deleteFeed
Delete a feed and all of its ingested content. Accepts a feed identifier which was returned from one of the ingestion tools, like ingestGoogleDriveFiles. Content deletion will happen asynchronously. Returns the feed identifier and feed state, i.e. Deleted.
deleteContent
Delete content. Accepts a content identifier. Returns the content identifier and content state, i.e. Deleted.
deleteContents
Deletes contents from Graphlit knowledge base. Accepts optional content type and file type filters to limit the contents which will be deleted. Also accepts optional limit of how many contents to delete, defaults to 1000. Returns the content identifiers and content state, i.e. Deleted.
deleteFeeds
Deletes feeds from Graphlit knowledge base. Accepts optional feed type filter to limit the feeds which will be deleted. Also accepts optional limit of how many feeds to delete, defaults to 100. Returns the feed identifiers and feed state, i.e. Deleted.
isContentDone
Check if content has completed asynchronous ingestion. Accepts a content identifier which was returned from one of the non-feed ingestion tools, like ingestUrl. Returns whether the content is done or not.
isFeedDone
Check if an asynchronous feed has completed ingesting all the available content. Accepts a feed identifier which was returned from one of the ingestion tools, like ingestGoogleDriveFiles. Returns whether the feed is done or not.
listMicrosoftTeamsTeams
Lists available Microsoft Teams teams. Returns a list of Microsoft Teams teams, where the team identifier can be used with listMicrosoftTeamsChannels to enumerate Microsoft Teams channels.
listMicrosoftTeamsChannels
Lists available Microsoft Teams channels. Returns a list of Microsoft Teams channels, where the channel identifier can be used with ingestMicrosoftTeamsMessages to ingest messages into Graphlit knowledge base.
listSlackChannels
Lists available Slack channels. Returns a list of Slack channels, where the channel name can be used with ingestSlackMessages to ingest messages into Graphlit knowledge base.
listSharePointLibraries
Lists available SharePoint libraries. Returns a list of SharePoint libraries, where the selected libraryId can be used with listSharePointFolders to enumerate SharePoint folders in a library.
listSharePointFolders
Lists available SharePoint folders. Returns a list of SharePoint folders, which can be used with ingestSharePointFiles to ingest files into Graphlit knowledge base.
ingestMicrosoftEmail
Ingests emails from Microsoft Email account into Graphlit knowledge base. Accepts an optional read limit for the number of emails to ingest. Executes asynchronously and returns the feed identifier.
ingestSharePointFiles
Ingests files from SharePoint library into Graphlit knowledge base. Accepts a SharePoint libraryId and an optional folderId to ingest files from a specific SharePoint folder. Libraries can be enumerated with listSharePointLibraries and library folders with listSharePointFolders. Accepts an optional read limit for the number of files to ingest. Executes asynchronously and returns the feed identifier.
ingestOneDriveFiles
Ingests files from OneDrive folder into Graphlit knowledge base. Accepts an optional read limit for the number of files to ingest. Executes asynchronously and returns the feed identifier.
ingestGoogleDriveFiles
Ingests files from Google Drive folder into Graphlit knowledge base. Accepts an optional read limit for the number of files to ingest. Executes asynchronously and returns the feed identifier.
ingestDropboxFiles
Ingests files from Dropbox folder into Graphlit knowledge base. Accepts optional relative path to Dropbox folder (i.e. /Pictures), and an optional read limit for the number of files to ingest. If no path provided, ingests files from root Dropbox folder. Executes asynchronously and returns the feed identifier.
ingestBoxFiles
Ingests files from Box folder into Graphlit knowledge base. Accepts optional Box folder identifier, and an optional read limit for the number of files to ingest. If no folder identifier provided, ingests files from root Box folder (i.e. "0"). Folder identifier can be inferred from Box URL. https://app.box.com/folder/123456 -> folder identifier is "123456". Executes asynchronously and returns the feed identifier.
ingestGitHubFiles
Ingests files from GitHub repository into Graphlit knowledge base. Accepts GitHub repository owner and repository name and an optional read limit for the number of files to ingest. For example, for GitHub repository (https://github.com/openai/tiktoken), 'openai' is the repository owner, and 'tiktoken' is the repository name. Executes asynchronously and returns the feed identifier.
ingestNotionPages
Ingests pages from Notion database into Graphlit knowledge base. Accepts an optional read limit for the number of messages to ingest. Executes asynchronously and returns the feed identifier.
ingestUrl
Ingests content from URL into Graphlit knowledge base. Can scrape web pages, and can ingest individual Word documents, PDFs, audio recordings, videos, images, or any other unstructured data. Executes asynchronously and returns the content identifier.
ingestMicrosoftTeamsMessages
Ingests messages from Microsoft Teams channel into Graphlit knowledge base. Accepts Microsoft Teams team identifier and channel identifier, and an optional read limit for the number of messages to ingest. Executes asynchronously and returns the feed identifier.
ingestSlackMessages
Ingests messages from Slack channel into Graphlit knowledge base. Accepts Slack channel name and an optional read limit for the number of messages to ingest. Executes asynchronously and returns the feed identifier.
ingestDiscordMessages
Ingests messages from Discord channel into Graphlit knowledge base. Accepts Discord channel name and an optional read limit for the number of messages to ingest. Executes asynchronously and returns the feed identifier.
ingestRedditPosts
Ingests posts from Reddit subreddit into Graphlit knowledge base. Accepts a subreddit name and an optional read limit for the number of posts to ingest. Executes asynchronously and returns the feed identifier.
ingestGoogleEmail
Ingests emails from Google Email account into Graphlit knowledge base. Accepts an optional read limit for the number of emails to ingest. Executes asynchronously and returns the feed identifier.
ingestLinearIssues
Ingests issues from Linear project into Graphlit knowledge base. Accepts Linear project name and an optional read limit for the number of issues to ingest. Executes asynchronously and returns the feed identifier.
ingestGitHubIssues
Ingests issues from GitHub repository into Graphlit knowledge base. Accepts GitHub repository owner and repository name and an optional read limit for the number of issues to ingest. For example, for GitHub repository (https://github.com/openai/tiktoken), 'openai' is the repository owner, and 'tiktoken' is the repository name. Executes asynchronously and returns the feed identifier.
ingestJiraIssues
Ingests issues from Atlassian Jira repository into Graphlit knowledge base. Accepts Atlassian Jira server URL and project name, and an optional read limit for the number of issues to ingest. Executes asynchronously and returns the feed identifier.
webCrawl
Crawls web pages from web site into Graphlit knowledge base. Accepts a URL and an optional read limit for the number of pages to crawl. Uses sitemap.xml to discover pages to be crawled from website. Executes asynchronously and returns the feed identifier.
webMap
Enumerates the web pages at or beneath the provided URL using web sitemap. Does *not* ingest web pages into Graphlit knowledge base. Accepts web page URL as string. Returns list of mapped URIs from web site.
webSearch
Performs web search based on search query. Format the search query as what would be entered into a Google search. Prefer calling this tool over using 'curl' directly for any web search. Does *not* ingest pages into Graphlit knowledge base. Accepts search query as string, and optional search service type. Can search for web pages, podcasts, videos, images, news, or shopping. Search service types: Tavily, Exa. Defaults to Tavily. Returns URL, title and relevant Markdown text from resulting web pages.
ingestRSS
Ingests posts from RSS feed into Graphlit knowledge base. For podcast RSS feeds, audio will be downloaded, transcribed and ingested into Graphlit knowledge base. Accepts RSS URL and an optional read limit for the number of posts to read. Executes asynchronously and returns the feed identifier.
ingestText
Ingests text as content into Graphlit knowledge base. Accepts a name for the content object, the text itself, and an optional text type (Plain, Markdown, Html). Defaults to Markdown text type. Can use for storing long-term textual memories or the output from LLM or other tools as content resources, which can be later searched or retrieved. Executes *synchronously* and returns the content identifier.
ingestFile
Ingests local file into Graphlit knowledge base. Accepts the path to the file in the local filesystem. Executes asynchronously and returns the content identifier.
screenshotPage
Screenshots web page from URL. Executes asynchronously and returns the content identifier.
describeImage
Prompts vision LLM and returns completion. Does *not* ingest image into Graphlit knowledge base. Accepts image URL as string. Returns Markdown text from LLM completion.
describeContent
Prompts vision LLM and returns description of image content. Accepts content identifier as string, and optional prompt for image description. Returns Markdown text from LLM completion.
README
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, Goose 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 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.
For any questions on using the MCP Server, please join our Discord community and post on the #mcp channel.
<a href="https://glama.ai/mcp/servers/fscrivteod"> <img width="380" height="200" src="https://glama.ai/mcp/servers/fscrivteod/badge" alt="graphlit-mcp-server MCP server" /> </a>
Tools
Retrieval
- Query Contents
- Query Collections
- Query Feeds
- Retrieve Relevant Sources
- Retrieve Similar Images
- Visually Describe Image
Extraction
- Extract Structured JSON from Text
Ingestion
- Files
- Web Pages
- Messages
- Posts
- Emails
- Issues
- Text
Data Connectors
- Microsoft Outlook email
- Google Mail
- Notion
- Linear
- Jira
- GitHub Issues
- Google Drive
- OneDrive
- SharePoint
- Dropbox
- Box
- GitHub
- Slack
- Microsoft Teams
- Discord
- Twitter/X
- Podcasts (RSS)
Web
- Web Crawling
- Web Search (including Podcast Search)
- Web Mapping
- Screenshot Page
Notifications
- Slack
- Webhook
- Twitter/X
Operations
- Configure Project
- Create Collection
- Add Contents to Collection
- Remove Contents from Collection
- Delete Collection(s)
- 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
- List Notion Databases
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 with access to the API settings dashboard.
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.
Installation
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, Cline 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:
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",
"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"
}
}
}
}
Support
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.
Recommended Servers
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
Playwright MCP Server
Provides a server utilizing Model Context Protocol to enable human-like browser automation with Playwright, allowing control over browser actions such as navigation, element interaction, and scrolling.
Apple MCP Server
Enables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
contentful-mcp
Update, create, delete content, content-models and assets in your Contentful Space
serper-search-scrape-mcp-server
This Serper MCP Server supports search and webpage scraping, and all the most recent parameters introduced by the Serper API, like location.
The Verge News MCP Server
Provides tools to fetch and search news from The Verge's RSS feed, allowing users to get today's news, retrieve random articles from the past week, and search for specific keywords in recent Verge content.
MCP Server Trello
Facilitates interaction with Trello boards via the Trello API, offering features like rate limiting, type safety, input validation, and error handling for seamless management of cards, lists, and board activities.
@kazuph/mcp-gmail-gas
Model Context Protocol server for Gmail integration. This allows Claude Desktop (or any MCP client) to interact with your Gmail account through Google Apps Script.
MCP DuckDB Knowledge Graph Memory Server
A memory server for Claude that stores and retrieves knowledge graph data in DuckDB, enhancing performance and query capabilities for conversations with persistent user information.
dbt Semantic Layer MCP Server
A server that enables querying the dbt Semantic Layer through natural language conversations with Claude Desktop and other AI assistants, allowing users to discover metrics, create queries, analyze data, and visualize results.