Skip to main content

​
Overview

The Syncline MCP server is available as an NPM package, making it easy to integrate with Claude Desktop, custom AI agents, or any MCP-compatible client.

​
Quick Install

Install the Syncline MCP server via NPM: 
npm install -g @kekwanulabs/syncline-mcp-server
Or install locally in your project: 
npm install @kekwanulabs/syncline-mcp-server

​
Requirements

Node.js

Node.js 18.0 or higher

Platform API Key

Get your API key from the developer dashboard

​
Configuration

​
Environment Variables

The MCP server requires your Syncline Platform API key: 
# Required
export SYNCLINE_API_KEY=sk_live_your_api_key_here

​
Verify Installation

Test that the server is installed correctly: 
syncline-mcp-server --version
You should see the version number output: 
1.0.1

​
Integration Methods

Add Syncline to your Claude Desktop configuration: 
{
  "mcpServers": {
    "syncline": {
      "command": "npx",
      "args": ["-y", "@kekwanulabs/syncline-mcp-server"],
      "env": {
        "SYNCLINE_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}
See the Claude Integration guide for complete setup instructions.

​
Option 2: Custom AI Agent (Python)

Use the Python MCP SDK to connect to the server: 
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

server_params = StdioServerParameters(
    command="npx",
    args=["-y", "@kekwanulabs/syncline-mcp-server"],
    env={"SYNCLINE_API_KEY": "sk_live_your_api_key_here"}
)

async with stdio_client(server_params) as (read, write):
    async with ClientSession(read, write) as session:
        await session.initialize()
        tools = await session.list_tools()
        print(f"Available tools: {[tool.name for tool in tools]}")
See the Python Client guide for more examples.

​
Option 3: Custom AI Agent (Node.js)

Use the Node.js MCP SDK: 
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

const transport = new StdioClientTransport({
  command: "npx",
  args: ["-y", "@kekwanulabs/syncline-mcp-server"],
  env: {
    ...process.env,
    SYNCLINE_API_KEY: "sk_live_your_api_key_here"
  }
});

const client = new Client({
  name: "my-agent",
  version: "1.0.0"
}, {
  capabilities: {}
});

await client.connect(transport);
const { tools } = await client.listTools();
console.log("Available tools:", tools.map(t => t.name));
See the Node.js Client guide for more examples.

​
Available Tools

Once installed, the MCP server provides 4 tools:
Find time slots where all attendees are available.Use case: AI agent needs to find meeting times
{
  "attendees": ["alice@example.com", "bob@example.com"],
  "duration_minutes": 30
}
Create a calendar event with Google Meet link.Use case: AI agent books a meeting
{
  "attendees": ["alice@example.com", "bob@example.com"],
  "start_time": "2025-01-22T14:00:00Z",
  "title": "Product Demo",
  "duration_minutes": 30
}
Check a single user’s calendar for a specific time range.Use case: See if someone is free on a specific day
{
  "email": "alice@example.com",
  "start_date": "2025-01-22",
  "end_date": "2025-01-22"
}
Update user scheduling preferences.Use case: User tells AI “I prefer morning meetings”
{
  "email": "alice@example.com",
  "preferences": {
    "energy_pattern": "morning_person"
  }
}

​
Troubleshooting

​
Command Not Found

If syncline-mcp-server command is not found after global install: 
# Verify npm global bin directory is in PATH
npm config get prefix

# Add to PATH if needed (add to ~/.bashrc or ~/.zshrc)
export PATH="$PATH:$(npm config get prefix)/bin"

​
API Key Issues

If you get “Invalid API key” errors:
  1. Verify your API key is correct
  2. Check the key starts with sk_live_ (not sk_test_)
  3. Ensure the environment variable is set:
echo $SYNCLINE_API_KEY

​
Version Conflicts

If you have issues with multiple versions: 
# Uninstall all versions
npm uninstall -g @kekwanulabs/syncline-mcp-server

# Reinstall latest
npm install -g @kekwanulabs/syncline-mcp-server@latest

​
Connection Issues

If the MCP server fails to connect:
  1. Check Node.js version: node --version (must be 18+)
  2. Verify network access to api.syncline.run
  3. Check firewall settings

​
Security Best Practices

Never commit your API key to version control!

​
Use Environment Variables

Store API keys in environment variables, not in code: 
# .env file (add to .gitignore!)
SYNCLINE_API_KEY=sk_live_your_api_key_here
Load environment variables in your app: 
import dotenv from 'dotenv';
dotenv.config();

const apiKey = process.env.SYNCLINE_API_KEY;

​
Rotate API Keys Regularly

Rotate your Platform API key every 90 days:
  1. Generate new key in developer dashboard
  2. Update environment variable
  3. Old key is immediately invalidated
See Platform API Key Regeneration for details.

​
Upgrading

To upgrade to the latest version: 
# Global install
npm update -g @kekwanulabs/syncline-mcp-server

# Local install
npm update @kekwanulabs/syncline-mcp-server
Check the changelog for breaking changes.

​
Uninstalling

To remove the MCP server: 
# Global install
npm uninstall -g @kekwanulabs/syncline-mcp-server

# Local install
npm uninstall @kekwanulabs/syncline-mcp-server

​
Next Steps

Claude Integration

Add Syncline to Claude Desktop

Python Client

Build custom Python agents

Node.js Client

Build custom Node.js agents