Skillget

sinch-plugins

skill
Security Audit
Warn
Health Warn
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Warn
  • process.env — Environment variable access in plugins/sinch-claude-plugin/skills/conversation-api/scripts/common/sinch_client.cjs
  • network request — Outbound network request in plugins/sinch-claude-plugin/skills/conversation-api/scripts/common/sinch_client.cjs
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This plugin integrates Sinch's Conversation API with AI development tools like Claude Code. It allows developers to send SMS messages and manage webhooks directly from their terminal.

Security Assessment
Overall risk: Low. The tool requires credentials (Project ID, Key ID, Key Secret) to be provided via environment variables, which is a standard and secure practice. There are no hardcoded secrets or dangerous permissions requested. The outbound network requests flagged in the audit are expected and necessary for the tool to communicate with the Sinch API to send messages and manage account configurations. There is no indication of unexpected data exfiltration or malicious shell execution.

Quality Assessment
The project uses the permissive Apache-2.0 license and has clear documentation to guide setup. It is actively maintained, with the most recent push occurring today. However, it currently has very low community visibility, with only 5 stars on GitHub. This means it has not been widely vetted by a large user base, so developers should be prepared to rely primarily on the official maintainer's code.

Verdict
Safe to use, though the standard caution applied to low-visibility, official vendor tools is advised.
SUMMARY

A plugin that enables seamless integration with Sinch APIs for messaging services. It provides developers with easy-to-use methods to send SMS within their applications.

README.md

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

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"
  }
}
  1. 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

Available product skills:

  • Messaging: conversation-api, in-app-calling
  • Phone numbers: numbers, number-lookup, 10dlc, elastic-sip-trunking
  • Voice & Verification: voice-api, verification-api
  • Fax: fax
  • Email: mailgun, mailgun-inspect, mailgun-optimize, mailgun-validate
  • Provisioning: provisioning-api
  • Auth: authentication

Product-oriented skills (from sinch-skills): conversation-api, voice-api, verification-api, numbers, 10dlc, fax, mailgun, mailjet, and more.

Gemini CLI

A Gemini CLI extension that integrates the Sinch Conversation API, allowing you to send SMS messages, manage webhooks, and interact with your Sinch configuration directly from Gemini CLI.

Installation

Install from GitHub

gemini extensions install https://github.com/sinch/sinch-plugins

Install from Local Path

cd skills/plugins/sinch-gemini-extension
gemini extensions install .

Configuration

During installation, Gemini CLI will automatically prompt you for your Sinch credentials:

  • CONVERSATION_PROJECT_ID: Your Sinch project ID (required)
  • CONVERSATION_KEY_ID: Your API key ID (required)
  • CONVERSATION_KEY_SECRET: Your API key secret (required, stored securely)
  • CONVERSATION_REGION: Your region (us, eu, or br) (required)
  • CONVERSATION_APP_ID: Your Sinch Conversation API App ID (required)

Verify Installation

# List installed extensions
gemini extensions list

# View extension settings
gemini extensions settings list sinch

Usage

Once installed, restart Gemini CLI and use the available commands:

# Start Gemini CLI
gemini

# Send a message
/sinch:api:messages:send --to=+14155551234 --message="Hello from Sinch"

# List webhooks
/sinch:api:webhooks:list

Available Commands

  • /sinch:api:messages:send - Send SMS messages
  • /sinch:api:webhooks:list - List webhooks
  • /sinch:api:webhooks:create - Create webhook
  • /sinch:api:webhooks:update - Update webhook
  • /sinch:api:webhooks:delete - Delete webhook
  • /sinch:api:webhooks:triggers - List available triggers
  • /sinch:api:senders:list - List active senders

Managing Settings

# View extension settings
gemini extensions settings list sinch

# Update a setting
gemini extensions settings set sinch "Key Secret"

Extension Management

# Update extension
gemini extensions update sinch

# Disable extension
gemini extensions disable sinch

# Enable extension
gemini extensions enable sinch

# Uninstall extension
gemini extensions uninstall sinch

For detailed documentation, see plugins/sinch-gemini-extension/.gemini-extension/README.md.

License

Apache-2.0

Copyright Sinch AB, https://sinch.com

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Further Reading

Developer Documentation: https://developers.sinch.com/docs/conversation/

Feedback, Issues and Support

We love hearing feedback, and we are here to help if you run into any issues.

  • For any Sinch Conversation API related issues, or support you require, head over to the Sinch Help Centre

We will continue to enhance this product with new features in future.

From all of us at Sinch, happy coding!

Use of Sinch Services

Use of Sinch Services

This repository contains plugins/code that enable developers to interact with Sinch APIs and services from supported developer tools or environments. Use of Sinch services requires a valid Sinch account and is subject to the applicable Sinch Terms of Service available at: https://sinch.com/legal/terms-and-conditions/other-sinch-terms-conditions/sinch-engage/sinch-engage-terms/

These plugins may be used with third-party developer tools, extensions, or platforms that are not operated or controlled by Sinch. The plugins are provided on an "as-is" basis, and Sinch is not responsible for the operation, availability, performance, security, or policies of such third-party tools or platforms.

Reviews (0)

No results found