Developers
Check out our API

Salesmsg MCP Server

Salesmsg MCP Tools let you connect your Salesmsg account to Claude Web, Claude Desktop, or any MCP-compatible AI agent. Once connected, the agent can search and update contacts, pull full conversation details, apply tags, and send text messages using natural-language commands.

What you can do

The Salesmsg MCP Server exposes the capabilities available to an MCP-compatible client after it is connected to Salesmsg. Actions run against the connected Salesmsg account through the Salesmsg Public API.

Once the MCP server is connected to your AI agent, you can:

Build and manage contacts
Find any contact, add new ones, and update records directly from your AI agent using natural-language commands.
Pull full contact profiles
Get every detail on a contact: name, phone, email, tags, custom fields, and opt-in status. Apply tags directly from the agent.
Find and review any conversation
Search your Salesmsg conversations by contact, keyword, or message content and pull full thread details.
Send text messages
Text any contact or phone number right from your AI agent, with inbox selection and opt-out compliance built in.

Supported clients

The MCP server works with any MCP-compatible AI agent. Confirmed clients:

Claude Web
Claude Desktop
Cursor
ChatGPT
Any other MCP-compatible client

Full install instructions and configuration examples live in the GitHub repository: github.com/salesmessage/ContactMCP

Install and connect

Installation instructions, configuration examples, and supported environment variables live in the GitHub repository.

Connect your Salesmsg account

Once connected, your agent can manage contacts, search conversations, apply tags, and send text messages using plain language commands, without opening the Salesmsg app.

1

Create a Salesmsg account

2

Open Claude Web or Claude Desktop

3

Go to Settings and select Connectors

4

Click the + icon to add a new connector

5

Enter Salesmsg as the connector name

6

Enter  https://mcp.salesmsg.com  as the Remote MCP Server URL

7

Click Add

8

Sign in with your existing Salesmsg credentials when prompted

9

Authorize the connection

What to expect

Your agent authenticates once and stays connected.

All actions run through your existing Salesmsg account and inboxes.

Opt-out compliance is handled automatically on every SMS send.

Contact updates apply only to the fields you mention. Other fields stay unchanged.

Available tools

After setup, your AI agent can access the Salesmsg tools listed below. Describe what you want in plain language — the agent will choose the appropriate tool.

Contacts
Get Contact
salesmsg_get_contact
Get Contacts Data
salesmsg_get_contacts_data
Search Contacts
salesmsg_search_contacts
Create Contact
salesmsg_create_contact
Update Contact
salesmsg_update_contact
Delete Contact
salesmsg_delete_contact
Tags
Add Tag to Contact
salesmsg_add_tag_to_contact
Remove Tag from Contact
salesmsg_remove_tag_from_contact
Manage Tags
salesmsg_manage_tags
Conversations
Get All Conversations
salesmsg_get_all_conversations
Get Conversation
salesmsg_get_conversation
Get Contact Conversation
salesmsg_get_contact_conversation
Search Conversations
salesmsg_search_conversations
Get Conversation Messages
salesmsg_get_conversation_messages
Get Conversation History
salesmsg_get_conversation_history
Get Messages Data
salesmsg_get_messages_data
Assign Conversation
salesmsg_assign_conversation
Inboxes
Get All Inboxes
salesmsg_get_all_inboxes
Get Inbox
salesmsg_get_inbox
Messaging
Send Message
salesmsg_send_message
Send SMS
salesmsg_send_sms
Schedule Message
salesmsg_schedule_message
System
Server Info
salesmsg_server_info

Limits

The MCP server runs against the Salesmsg Public API and inherits its limits.

Rate limit: 60 requests per minute, global.

Exceeding the limit returns HTTP 429.

The server reflects API errors back to the client with the original status code and message.

FAQ

Do I need a separate login to use Salesmsg via MCP?

No. You authenticate using your existing Salesmsg username and password during the initial connection. No separate credentials are needed.

Does this work with AI agents other than Claude?

Yes. Salesmsg MCP Tools work with any MCP-compatible AI agent, not just Claude Web or Claude Desktop.

Can I send from any inbox?

Yes. When sending SMS, you can specify which Salesmsg inbox to send from. If you do not specify, your agent will use your default inbox.

What happens if a contact has opted out?

Your agent checks opt-out status automatically before sending. If the contact has opted out, the message will not be sent. Full details in the Help Center