graphlit-mcp-server

Official

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
JIRA_EMAILNoYour Jira email for Jira data connector integration
JIRA_TOKENNoYour Jira token for Jira data connector integration
LINEAR_API_KEYNoYour Linear API key for Linear data connector integration
NOTION_API_KEYNoYour Notion API key for Notion data connector integration
SLACK_BOT_TOKENNoYour Slack bot token for Slack data connector integration
DISCORD_BOT_TOKENNoYour Discord bot token for Discord data connector integration
NOTION_DATABASE_IDNoYour Notion database ID for Notion data connector integration
GRAPHLIT_JWT_SECRETYesYour JWT secret for signing the JWT token found in the API settings dashboard
GOOGLE_EMAIL_CLIENT_IDNoYour Google client ID for Google Mail data connector integration
GRAPHLIT_ENVIRONMENT_IDYesYour Graphlit environment ID found in the API settings dashboard
GRAPHLIT_ORGANIZATION_IDYesYour Graphlit organization ID found in the API settings dashboard
GOOGLE_EMAIL_CLIENT_SECRETNoYour Google client secret for Google Mail data connector integration
GOOGLE_EMAIL_REFRESH_TOKENNoYour Google refresh token for Google Mail data connector integration
GITHUB_PERSONAL_ACCESS_TOKENNoYour GitHub personal access token for GitHub data connector integration

Schema

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Tools

Functions exposed to the LLM to take actions

NameDescription
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.

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.

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.

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.

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.

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.

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.