sinch-claude-plugin

Sinch Plugins

This repository contains Sinch plugins and related artifacts for AI developer tools.

Claude Code

A Claude Code plugin that integrates the Sinch Conversation API, allowing you to send SMS messages, manage webhooks, and inspect your Sinch configuration directly from your terminal.

Features

• Send Messages: Send text messages via SMS.
• Manage Webhooks: Create, list, update, and delete webhooks for your Conversation API app.
• List Senders: View active phone numbers and senders.
• MCP Integration: Built on top of the Model Context Protocol (MCP).

Prerequisites

• Claude Code installed.
• A Sinch Customer Dashboard account.
• A Conversation API app with credentials (Project ID, Key ID, Key Secret, App ID, App Region).

Installation

To install this plugin in Claude Code, you typically install it from a marketplace or a local source.

/plugin marketplace add https://github.com/sinch/sinch-plugins.git
/plugin install sinch-claude-plugin

Configuration

This plugin relies on the Sinch MCP server, which requires specific environment variables to authenticate with the Sinch API. These variables must be set in your Claude Code settings.

Required Environment Variables

You need to configure the following variables:

• CONVERSATION_PROJECT_ID: Your Sinch Project ID.
• CONVERSATION_KEY_ID: Your Access Key ID.
• CONVERSATION_KEY_SECRET: Your Access Key Secret.
• CONVERSATION_REGION: The region for your app (e.g., us, eu, br).
• CONVERSATION_APP_ID: The specific Conversation App ID you want to use.

Get Your Sinch Credentials

Get access and create your access key: You will need a Sinch Build account (see here for instructions on setting up an account). Once you have created an account and logged in, select Conversation API from the left menu. Review the terms and conditions, select the I agree to the terms and conditions check box, and click GET ACCESS to proceed. Then, create your access key. Access keys are used to authenticate calls when using Conversation API. Access keys are generated in the Sinch Build Dashboard. If you need assistance, you can review our Community article on access key creation.

Setup Methods

Option 1: Automated Setup (Recommended)

We provide setup scripts to help you configure these variables interactively.

macOS / Linux: Run the shell script located in the plugin configuration folder:

./plugins/sinch-claude-plugin/commands/config/init_mcp_cred.sh

Option 2: Manual Configuration

1. Open your Claude Code settings file. On macOS/Linux, this is usually ~/.claude/settings.json.
2. Add or update the env object with your credentials:

{
  "env": {
    "CONVERSATION_PROJECT_ID": "your-project-id",
    "CONVERSATION_KEY_ID": "your-key-id",
    "CONVERSATION_KEY_SECRET": "your-key-secret",
    "CONVERSATION_REGION": "your-app-region (e.g., us, eu, br)",
    "CONVERSATION_APP_ID": "your-app-id"
  }
}

3. Restart Claude Code for the changes to take effect.

Usage

Once installed and configured, you can use natural language or specific slash commands to interact with the API.

Common Commands

• Setup Help:

  /sinch-claude-plugin:sinch-help
  

• Send a Message:

  /sinch-claude-plugin:api:messages:send --to=+15551234567 --message="Hello from Claude!"
  

• List Webhooks:

  /sinch-claude-plugin:api:webhooks:list
  

• List Active Senders:

  /sinch-claude-plugin:api:senders:list
  

Architecture

This plugin leverages the Sinch MCP Server to communicate with the Sinch Conversation API. It defines a set of tools and prompts that Claude Code uses to perform actions on your behalf.

Skills

Skills are natural-language workflows that guide Claude through common tasks.

Source repository

The skills catalog is maintained at github.com/sinch/skills.

Install with npx

npx skills add sinch/skills

• Skills live under plugins/sinch-claude-plugin/skills.
• Skills are shared from sinch-skills via git submodule
• Skills are also published as a standalone artifact in this repository's Releases.

Available product skills: