How to connect Spoki to Claude Cowork

Trusted by
AWS
Glean
Zoom
Airtable

30 min · no commitment · see it on your stack

Spoki logo
Claude Cowork logo
divider

Introduction

Cowork is Anthropic's AI agent for knowledge work. Think of it as Claude Code for everything else. It works autonomously with your computer, local files, and applications to accomplish complex tasks.

This guide walks you through the easiest and most secure way to connect your Spoki account to Cowork via Composio Connect, enabling it to list all WhatsApp campaigns scheduled this week, get current report for your Spoki account, update contact details for customer Mario Rossi, and more such actions on your behalf without compromising your account security.

Also integrate Spoki with

Connecting Spoki to Claude Cowork

1. Open Customize

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

2. Add the Composio MCP server

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

3. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Cowork

4. Connect your Spoki account

Back in Cowork, ask the agent to connect to Spoki or give it any Spoki-related task.

For example, ask Cowork to:

  • "List all WhatsApp campaigns scheduled this week"
  • "Get current report for your Spoki account"
  • "Update contact details for customer Mario Rossi"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Cowork, and your Spoki account is ready to use.

What is Claude Cowork?

Claude Cowork is Anthropic's agent for general knowledge work. It can use your computer, files, and connected applications to complete longer-running tasks across your work tools.

With Composio Connect, Cowork can securely access apps like Spoki through MCP without you sharing account credentials directly with the agent.

What is the Spoki MCP server, and what's possible with it?

The Spoki MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Spoki account. It provides structured and secure access to your WhatsApp communication workflows, so your agent can manage contacts, send and organize campaigns, retrieve reports, and automate marketing or support tasks with ease.

  • Contact management and automation: Instantly create, update, or delete WhatsApp contacts, and enrich them with custom fields for personalized messaging and streamlined communication.
  • Campaign and automation insights: Let your agent list, search, and filter campaigns or automations, enabling real-time oversight and optimization of your marketing or support workflows.
  • Template and tag organization: Effortlessly retrieve, search, and manage WhatsApp message templates and tags, so your agent can keep communication assets organized and ready to use.
  • Account reporting and analytics: Obtain current reports on message and conversation metrics, giving your agent the power to monitor campaign performance and engagement at a glance.
  • Agency and team coordination: Fetch all accessible agencies for the authenticated account, supporting seamless collaboration across teams or business units from within your AI workflows.

Supported Tools & Triggers

Tools
Add Contact OperatorTool to assign an operator to a contact's chat.
Add Service UserAdds a new service user with a specific role to your Spoki account.
Check Role Private KeyTool to check if a service user role has a private key configured.
Clone TemplateTool to create a duplicate copy of an existing template.
Create Account Onboarding LinkTool to create an onboarding link for a specific Spoki account.
Create Custom FieldCreates a new custom field in Spoki for storing additional contact data.
Create Contact ListCreates a new contact list in Spoki for organizing and managing contacts.
Create Media FileTool to create a new media file entry in Spoki.
Create or Update ContactCreates a new contact or updates an existing contact in Spoki using the phone number as the unique identifier.
Create TemplateCreates a new WhatsApp message template with localizations, buttons, and media headers.
Create TicketTool to create a new support ticket in Spoki.
Delete contactTool to delete a specific contact.
Delete Custom FieldTool to delete a specific custom field.
Delete listTool to delete a specific list.
Delete media fileTool to delete a specific media file.
Delete roleTool to delete a specific role.
Delete templateTool to delete a WhatsApp template.
Delete ticketTool to delete a specific ticket.
Generate Role Private KeyTool to generate a private key for a service user role.
Get Account Current ReportTool to get the current report for a specified account.
List AccountsTool to retrieve a list of Spoki WhatsApp Business accounts with their details.
List AgenciesTool to list all agencies accessible to the user.
List AutomationsTool to list, search, and filter automations.
List campaignsTool to list, search, and filter campaigns.
List ContactsTool to list, search, and filter contacts.
List Custom FieldsTool to list, search, and filter custom fields.
List ListsTool to list, search, and filter contact lists.
List mediaTool to list media files.
List PartnersList all partners accessible to the authenticated account.
List ReportsTool to list, search, and filter usage reports.
List RolesTool to list user roles in the system.
List tagsLists all tags in the account.
List templatesTool to list, search, and filter WhatsApp templates.
List TicketsTool to list, search, and filter tickets.
Remove All List ContactsTool to remove all contacts from a list.
Remove Contact OperatorTool to remove an operator from a contact's chat.
Remove Contacts from ListTool to remove specific contacts from a list.
Resend InvitationTool to resend an invitation email.
Retrieve AccountRetrieves detailed information about a specific Spoki WhatsApp Business account.
Retrieve AutomationTool to retrieve details of a specific automation.
Retrieve ContactTool to retrieve details of a specific contact.
Retrieve Custom FieldTool to retrieve details of a specific custom field.
Retrieve ListTool to retrieve details of a specific list by ID.
Retrieve MediaTool to retrieve details of a specific media file by ID.
Retrieve RoleTool to retrieve details of a specific role by ID.
Retrieve TagTool to retrieve details of a specific tag.
Retrieve TemplateTool to retrieve details of a specific template.
Revert Template to DraftTool to revert a WhatsApp template back to DRAFT status, removing it from WhatsApp.
Bulk Sync ContactsTool to bulk sync (create or update) multiple contacts in a single request.
Sync Contacts to ListTool to create or update contacts and add them to a specific list in Spoki.
Update CampaignTool to update an existing campaign's name, status, or scheduled time.
Update ContactTool to update an existing contact in Spoki.
Update Custom FieldTool to update a specific custom field.
Update Invitation RoleTool to update the role of a pending invitation.
Update MediaTool to update an existing media file in Spoki.
Update RoleTool to update a user's role.
Update TemplateTool to update an existing WhatsApp template in Spoki.

How to build Spoki MCP Agent with another framework

FAQ

What are the differences in Tool Router MCP and Spoki MCP?

With a standalone Spoki MCP server, the agents and LLMs can only access a fixed set of Spoki tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Spoki and many other apps based on the task at hand, all through a single MCP endpoint.

Can I use Tool Router MCP with Claude Cowork?

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Spoki tools.

Can I manage the permissions and scopes for Spoki while using Tool Router?

Yes, absolutely. You can configure which Spoki scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Spoki data and credentials are handled as safely as possible.

Used by agents from

Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.