Platform guides

Step-by-step instructions for connecting each platform. Click a platform to jump to its guide.

in LinkedIn

OAuth access token, post text and video.

🎵 TikTok

Login Kit OAuth flow, upload video.

💬 WhatsApp

Business API, templates, inbound webhooks.

📷 Instagram

Business account, Graph API token.

𝕏 Twitter / X

API v2 credentials, tweet with media.

✈️ Telegram

Bot token from BotFather.

in LinkedIn

What you can do

Connecting LinkedIn

  1. Create a LinkedIn app Go to developer.linkedin.com/apps and create a new app. Add your company page and request the w_member_social and r_liteprofile products.
  2. Generate an access token Use the LinkedIn OAuth 2.0 token generator in your app dashboard, or use the 3-legged OAuth flow. Copy the access token (valid 60 days; refresh tokens extend to ~12 months).
  3. Paste into SquareMCP dashboard Open the SquareMCP dashboard → LinkedIn → Connect → paste your access token → Save.

Available tools

Example prompts

Post a LinkedIn update: "Excited to announce our new product launch!"

Post a LinkedIn video from /tmp/demo.mp4 with caption "Watch our product demo"

Search my LinkedIn connections for people at Anthropic

Send a LinkedIn message to John Smith saying "Great meeting you at the conference"
Token refresh LinkedIn access tokens expire after 60 days. SquareMCP will automatically attempt a refresh using the refresh token. If refresh fails (e.g., the user revokes access), reconnect from the dashboard.

🎵 TikTok

What you can do

Connecting TikTok

  1. OAuth via SquareMCP dashboard Open the SquareMCP dashboard → TikTok → Connect. You'll be redirected to TikTok to authorise the app. SquareMCP uses TikTok Login Kit with video.publish and user.info.basic scopes.
  2. Allow the requested permissions TikTok shows the requested scopes. Click Authorize. You'll be redirected back to the dashboard with a "Connected" badge.

Uploading a video

Videos must be hosted at a publicly accessible URL. The tool uploads the video to TikTok's servers asynchronously — use tiktok_get_video_status to poll for completion.

Example prompts

Upload the video at https://cdn.example.com/demo.mp4 to TikTok
with caption "Check out our new feature! #AI #productlaunch"
and set privacy to PUBLIC_TO_EVERYONE

Check the status of my last TikTok upload
TikTok sandbox vs. production TikTok's Content Posting API requires app approval for production use. New apps start in sandbox mode (videos published to a test account only). Apply for production access through the TikTok developer portal.

💬 WhatsApp

What you can do

Prerequisites

You need a WhatsApp Business Account and a phone number registered through the Meta Business Manager.

Connecting WhatsApp

  1. Get your credentials from Meta In Meta for Developers → Your App → WhatsApp → API Setup:
    • Phone Number ID — the ID of your registered number
    • Business Account ID — your WABA ID
    • Permanent Access Token — generate from System Users in Business Manager
  2. Enter credentials in dashboard Open SquareMCP dashboard → WhatsApp → Connect → paste all three values → Save.
  3. Configure the webhook (optional — for inbound messages) In Meta for Developers → Webhooks, set the callback URL to https://hermes.squaremcp.com/webhook/whatsapp and the verify token to your WA_VERIFY_TOKEN (ask support for this). Subscribe to the messages field. Then configure a forwarding URL in SquareMCP dashboard → Webhooks so inbound messages reach your server.

Sending messages

Freeform message (within 24-hour session window)

Send a WhatsApp message to +447911123456 saying:
"Hi! Your order #12345 has shipped and will arrive tomorrow."

Template message (anytime)

List my WhatsApp message templates

Send the "order_confirmation" template to +447911123456
with variables: order_id=12345, delivery_date="14 May 2026"
24-hour rule WhatsApp only allows freeform messages within 24 hours of a customer contacting you first. Outside that window, use approved template messages.

📷 Instagram

What you can do

Connecting Instagram

Instagram posting requires a Business or Creator account connected to a Facebook Page.

  1. Get a Graph API access token Open the Graph API Explorer, select your app, and request instagram_basic, instagram_content_publish, and pages_read_engagement permissions. Generate a User Access Token and exchange it for a long-lived token.
  2. Find your Business Account ID Call GET /me/accounts then GET /{page_id}?fields=instagram_business_account to find your Instagram Business Account ID.
  3. Enter credentials in dashboard SquareMCP dashboard → Instagram → Connect → paste the access token and Business Account ID.

Example prompts

Post an Instagram reel from https://cdn.example.com/reel.mp4
with caption "Behind the scenes of our product shoot 🎬 #startup"

Get my last 10 Instagram posts

𝕏 Twitter / X

Connecting Twitter / X

  1. Create a developer app Go to developer.twitter.com and create a project and app. Enable OAuth 1.0a with Read and Write permissions.
  2. Generate all four credentials In your app → Keys and tokens: copy the API Key, API Secret, Access Token, and Access Token Secret (all four are required).
  3. Enter credentials in dashboard SquareMCP dashboard → Twitter / X → Connect → paste all four values.

Example prompts

Tweet: "We just shipped our v2 release 🚀 Read the changelog at squaremcp.com"

Upload the video at /tmp/demo.mp4 and tweet "Watch our new feature demo!"

Search Twitter for tweets mentioning "SquareMCP"

✈️ Telegram

Connecting Telegram

  1. Create a bot with BotFather Open Telegram and message @BotFather. Send /newbot, choose a name and username, and copy the API token it provides (format: 123456789:ABCdef...).
  2. Enter the token in dashboard SquareMCP dashboard → Telegram → Connect → paste the bot token.
  3. Add your bot to a chat or group Bots can only send messages to chats they're a member of. Add your bot to the target chat, then use telegram_get_updates to find the chat ID.

Example prompts

Send a Telegram message to chat ID -1001234567890 saying "Daily report ready!"

Get the latest Telegram messages in my channel