CommSync MCP

Agent documentation for the CommSync Model Context Protocol server.

For AI agents: fetch the plain text version for machine-readable instructions:

https://commsync.gg/docs/mcp.txt

Connection

Endpoint: https://server.commsync.gg/api/mcp
Transport: HTTP POST (stateless)
Auth: Authorization: Bearer csk_...

Create API keys in CommSync → Settings → API Keys.

Available Tools (52)

Thread Management

list_threadsList conversation threads with pagination and filtering
get_thread_messagesGet messages for a thread, ordered oldest first
get_thread_send_optionsGet available send-from handles for a thread
mark_thread_readMark a thread as read
mark_thread_unreadMark a thread as unread
archive_threadArchive a thread (propagates to IMAP)
unarchive_threadUnarchive a thread
delete_threadDelete a thread and all messages (irreversible)

Messaging

send_smsSend an SMS reply in an existing thread
send_emailSend an email reply in an existing thread
compose_smsStart a new SMS conversation
compose_emailStart a new email conversation
forward_messageForward a message to a new recipient
resend_failed_messageRe-queue a failed message for retry

Contacts

list_contactsList all contacts with identities
get_contactGet a contact by ID with identities and labels
create_contactCreate a new contact
update_contactUpdate contact name or notes
delete_contactDelete a contact (irreversible)
merge_identitiesMerge two identities under one contact
split_identityDetach an identity from its contact
attach_identity_to_contactAttach orphan identity to existing contact
promote_identity_to_contactPromote orphan identity to new contact

Identities

get_identityGet an identity with its associated contact
update_identity_notesUpdate notes on an identity
list_orphaned_identitiesList identities not attached to any contact
list_all_identitiesList all identities with contacts

Labels

list_labelsList all labels with usage counts
create_labelCreate a label with name and hex color
update_labelUpdate label name, color, or AI settings
delete_labelDelete a label from all contacts/identities
assign_labelAssign a label to a contact or identity
unassign_labelRemove a label from a contact or identity

Merge Suggestions

list_pending_suggestionsList pending identity merge suggestions
action_suggestionAccept, reject, or snooze a suggestion

Search

searchSearch across contacts, identities, and messages

AI Features

get_ai_settingsGet AI feature configuration
update_ai_settingsUpdate AI feature configuration
get_todays_digestGet AI daily digest for today
list_digestsList recent AI daily digests
dismiss_digestMark a digest as dismissed
trigger_digest_runManually trigger digest generation
list_ai_runsList recent AI audit entries
test_ai_connectivityTest AI service connectivity
trigger_merge_backfillTrigger merge suggestion backfill

Phone Numbers

list_phone_numbersList all phone numbers
add_phone_numberAdd a phone number
delete_phone_numberDelete a phone number

Email Accounts

list_email_accountsList email accounts (credentials hidden)
add_email_accountAdd an IMAP/SMTP email account
delete_email_accountDelete an email account
test_email_accountTest stored IMAP/SMTP credentials

Account

get_profileGet current user profile
update_profileUpdate current user name

Resources

commsync://threads/{threadId}/messages — Messages in a thread
commsync://contacts/{personId} — Contact detail
commsync://digests/{localDate} — AI digest for a date