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 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.
You can read more about the MCP Server use cases and features on our blog.
- Retrieve Sources
- Visually Describe Images
- Extract Structured JSON from Text
- Files
- Web Pages
- Text
- Microsoft Outlook email
- Google Mail
- Notion
- Linear
- Jira
- GitHub Issues
- Google Drive
- OneDrive
- SharePoint
- Dropbox
- Box
- GitHub
- Slack
- Microsoft Teams
- Discord
- Podcasts (RSS)
- Web Crawling
- Web Search
- Web Mapping
- Screenshot Page
- Slack
- Webhook
- Create Collection
- Add Contents to Collection
- Remove Contents from Collection
- Delete Collection
- Delete Feed(s)
- Delete Content(s)
- Is Feed Done?
- Is Content Done?
- List Slack Channels
- List Microsoft Teams Teams
- List Microsoft Teams Channels
- List SharePoint Libraries
- List SharePoint Folders
- List Linear Projects
- Project
- Contents
- Feeds
- Collections (of Content)
- Workflows
- Specifications
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.
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 Claude Desktop 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.
{
"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",
"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",
"NOTION_DATABASE_ID": "your-notion-database-id"
}
}
}
}
To install the Graphlit MCP Server, use npx:
npx install graphlit-mcp-server
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.
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.