Tesselith
ProductSolutionsAI agentsCompareFree toolsBlogPricing
Join the waitlist
  1. Home/
  2. AI agents/
  3. Gemini CLI
+Gemini CLI + Tesselith

How to connect Gemini CLI to Tesselith

Add Tesselith to Gemini CLI and schedule social posts from your terminal with Google's Gemini. Gemini CLI talks to Tesselith’s MCP server, so it can draft, queue and schedule posts on every channel you’ve connected. Keep a human in the loop: publishing now and deleting always ask for your confirmation.

Join the waitlistMCP docs

What do I need before connecting?

You need Gemini CLI installed and a Tesselith workspace on Pro, Team or Agency (every new workspace starts with a 14-day Pro trial) with at least one channel connected.

1 · Connect · a few minutes

Run this

terminal
# 1. Add the Tesselith MCP server for your user
gemini mcp add -s user --transport http tesselith https://api.tesselith.com/mcp

# 2. Start Gemini CLI and sign in
gemini
/mcp auth tesselith

2 · Ask · live in Tesselith

Ask Gemini CLI to post for you

Write a YouTube community-style update and queue it on Threads.

Used Tesselith · create_draft · add_to_queue

Queued a 480-character Threads post for the next free slot, Thursday at 12:00.

Also try:

  • “List my Tesselith channels.”
  • “What's scheduled tomorrow?”
  • “Draft posts for every channel announcing our webinar.”

The setup at a glance

  1. Add the server
  2. Sign in with /mcp auth
  3. Check it's connected
  4. Ask Gemini

One connection, every channel

Connect your accounts in Tesselith once. From then on Gemini CLI can plan and schedule for any of them, and Tesselith publishes at the time you set, even after the conversation ends.

  • XSoon
  • Instagram
  • Facebook
  • LinkedInSoon
  • Threads
  • YouTube
  • TikTokSoon
  • DiscordSoon
  • Telegram
  • RedditSoon
  • PinterestSoon
  • Bluesky
  • Mastodon
  • Dev.toSoon
  • HashnodeSoon

How do I connect Gemini CLI to Tesselith, step by step?

  1. 1. Add the server

    -s user saves it to ~/.gemini/settings.json for every project; without it, it's saved to the current project's .gemini/settings.json.

    ~/.gemini/settings.json
    {
      "mcpServers": {
        "tesselith": {
          "httpUrl": "https://api.tesselith.com/mcp"
        }
      }
    }
  2. 2. Sign in with /mcp auth

    Start gemini and run /mcp auth tesselith. A Tesselith window opens. Sign in, pick the workspace, untick anything you don't want the agent to do, and click Allow access.

  3. 3. Check it's connected

    Run /mcp. Tesselith should show as CONNECTED with its tools. Outside a session, gemini mcp list does the same.

  4. 4. Ask Gemini

    Ask Gemini to list your Tesselith channels, then to draft or queue a post. It confirms each tool call unless you trust the server.

Can I use an API key instead of signing in?

For headless runs, pass a key as a header. In Tesselith, open Settings → Developers, create an API key and tick only the scopes the agent needs. Keys start with tsl_live_ and are shown once, so store it in your password manager or a secret store.

terminal
gemini mcp add -s user --transport http \
  --header "Authorization: Bearer $TESSELITH_API_KEY" \
  tesselith https://api.tesselith.com/mcp

What can Gemini CLI do in Tesselith?

The server at https://api.tesselith.com/mcp exposes these tools. Gemini CLI only gets the permissions you approve, and never more than your own role.

Tesselith MCP tools available to Gemini CLI
What it does
list_channelsLists your connected accounts and their status
list_posts / get_postFinds posts by status or channel, or reads one
get_queueShows a channel's upcoming posts and free slots
suggest_best_timeSuggests the next free slot and your best hours
get_analytics_summaryCounts active channels, drafts and published posts
create_draftDrafts a post for one or more channels
update_postChanges a post's text, channels or media
add_to_queueGives a post the channel's next free slot
schedule_postPins a post to an exact time
upload_media_from_urlAttaches an image or video from a public URL
publish_nowPublishes within a minute, only after you confirm
delete_postDeletes a post, only after you confirm

Why is Gemini CLI not working with Tesselith?

Almost every failure is one of these. Tesselith returns a readable error, so asking Gemini CLI“what went wrong?” usually points at the right row.

Troubleshooting Gemini CLI with Tesselith
Fix
Connects as SSE and failsThe entry uses url instead of httpUrl. Use httpUrl, or re-add with --transport http.
Server not found in other projectsThe default scope is the project. Re-add it with -s user.
DISCONNECTED after a 401Run /mcp auth tesselith again, or use an API key header.
403: your plan doesn't include API accessMCP is included on Pro, Team and Agency. New workspaces get a 14-day Pro trial; upgrade under Settings → Billing.
401: connection revoked or lost accessSomeone disconnected the assistant in Settings → AI assistants, or your role changed. Connect again and approve the workspace.
The assistant can read posts but can't scheduleYou unticked Schedule and queue on the consent screen. Disconnect and connect again, keeping that permission.
No channels foundThe assistant only sees accounts already connected in Tesselith. Connect them under Channels first.
Post scheduled at the wrong timeTell the assistant your time zone. Tesselith takes ISO 8601 times with an offset, and your workspace time zone is shown in get_queue.
429: rate limitedEach connection can make 120 requests a minute on Pro, 300 on Team and 600 on Agency. Wait for the Retry-After seconds.

Gemini CLI and Tesselith: frequently asked questions

Where does Gemini CLI store the sign-in?
Tokens are saved in ~/.gemini/mcp-oauth-tokens.json.
Should I use --trust?
Only if you're happy for Gemini to call every Tesselith tool without asking. Leave it off so scheduling and publishing need your approval.

Gemini CLI’s own documentation: Google docs.

Connect other AI agents

ClaudeClaude CodeClaude CoworkChatGPTCodexOpenAI APICursorVS Code (GitHub Copilot)WindsurfZedClineHermes AgentOpenClawGoosen8nMistral Le ChatPerplexityManus

Ready to connect Gemini CLI?

Create your Tesselith account, connect your channels, and Gemini CLI can start scheduling in minutes.

Join the waitlist

Opening soon

Be first in when the doors open.

Join the waitlist and you'll be in the first wave of invites. One email when it opens, nothing else.

Join the waitlist
Tesselith

The social scheduler for creators, teams and agencies. One calendar, every network you post to.

Product

  • Composer
  • Calendar
  • Analytics
  • Automation
  • AI assistant
  • Posting queue
  • API & webhooks
  • MCP server
  • All features

AI agents

  • Claude
  • Claude Code
  • ChatGPT
  • Codex
  • Cursor
  • Gemini CLI
  • n8n
  • All AI agents

Solutions

  • Creators
  • Agencies
  • Small business
  • E-commerce
  • All solutions

Compare

  • Scheduler pricing 2026
  • vs Buffer
  • vs Hootsuite
  • Metricool alternatives
  • Planoly alternatives
  • All comparisons
  • All alternatives

Free tools

  • Character counter
  • Best time to post
  • UTM builder
  • Engagement rate
  • All tools

Company

  • About
  • Blog
  • Research
  • Developer docs
  • Pricing
  • Contact
  • Security
  • Status

Legal

  • Privacy
  • Terms
  • Cookies
  • Acceptable Use
  • DPA
  • Refunds

Schedule posts for

  • X (Twitter)
  • Instagram
  • Facebook Pages
  • LinkedIn
  • YouTube
  • TikTok
  • Threads
  • Bluesky
  • Mastodon
  • Pinterest
  • Reddit
  • Discord
  • Telegram
  • Dev.to
  • Hashnode
© 2026 Tesselith. All rights reserved.
PrivacyTermsCookiesSecurityData deletion
Tesselith