Integrate SDK

A type-safe TypeScript SDK for connecting to the Integrate MCP (Model Context Protocol) server. Access GitHub, Gmail, Notion, and other integrations through a simple, plugin-based API.

Server: https://mcp.integrate.dev/api/v1/mcp

What is this SDK?

This SDK is a client library that connects to the Integrate MCP server to access various third-party integrations.

Key concepts:

1. Connect to the Integrate MCP server - The SDK connects to https://mcp.integrate.dev/api/v1/mcp
2. Configure OAuth credentials - You provide your own OAuth app credentials for each integration (GitHub, Gmail, etc.)
3. Call tools - Execute actions like creating GitHub issues, sending emails, searching Notion pages
4. OAuth flow happens server-side - The SDK sends your OAuth config to the server, which handles the actual authentication flow

Important: You need to create your own OAuth apps (e.g., GitHub OAuth app, Google OAuth app) and provide the credentials to the SDK. The SDK does not provide OAuth credentials.

Features

• 🔌 Plugin-Based Architecture - Enable only the integrations you need
• 🔒 Type-Safe - Full TypeScript support with IntelliSense
• 🌊 Real-time Communication - HTTP streaming with NDJSON
• 🔐 OAuth Ready - Configure OAuth credentials for each provider
• 🛠️ Extensible - Create custom plugins for new integrations
• 📦 Zero Dependencies - Lightweight implementation

Get Started

How It Works

1. Client Configuration: You configure the SDK with plugins for the integrations you want to use (GitHub, Gmail, etc.)
2. Connection: The SDK connects to https://mcp.integrate.dev/api/v1/mcp using HTTP streaming (NDJSON)
3. Tool Discovery: The SDK fetches available tools from the server and filters them based on your enabled plugins
4. OAuth Configuration: Your OAuth credentials are stored in the client configuration (not sent to the server yet)
5. Tool Calls: When you call a tool, the SDK sends a JSON-RPC request to the server
6. OAuth Flow: The server uses your OAuth configuration to authenticate and execute the tool

Server Information

• Endpoint: https://mcp.integrate.dev/api/v1/mcp
• Protocol: MCP (Model Context Protocol) over HTTP streaming
• Format: Newline-delimited JSON (NDJSON)
• Methods: initialize, tools/list, tools/call