Installation

Install and configure the Syncline MCP server

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

Option 1: Claude Desktop (Recommended)

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_mutual_availability

Find time slots where all attendees are available.

Use case: AI agent needs to find meeting times

{
  "attendees": ["[e-mail]", "[e-mail]"],
  "duration_minutes": 30
}

schedule_meeting

Create a calendar event with Google Meet link.

Use case: AI agent books a meeting

{
  "attendees": ["[e-mail]", "[e-mail]"],
  "start_time": "2025-01-22T14:00:00Z",
  "title": "Product Demo",
  "duration_minutes": 30
}

check_availability

Check a single user’s calendar for a specific time range.

Use case: See if someone is free on a specific day

{
  "email": "[e-mail]",
  "start_date": "2025-01-22",
  "end_date": "2025-01-22"
}

update_preferences

Update user scheduling preferences.

Use case: User tells AI “I prefer morning meetings”

{
  "email": "[e-mail]",
  "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