AI assistant integration

Connect ClipHabit to Claude, ChatGPT and Gemini.

Use your assistant to plan your TikTok week, build a simple vertical video, write captions, manage the queue, and prepare posts. ClipHabit runs a remote MCP server on Pro and Agency plans.

MCP endpoint: https://app.cliphabit.com/mcp

Sign in to ClipHabit through OAuth when your client prompts you. You need an active ClipHabit Pro or Agency plan. Your AI client's own plan and workspace settings may also limit MCP access.

What can your assistant do?

ClipHabit is a TikTok scheduler and publishing app. Its MCP connection lets compatible assistants read your connected accounts, slots, queue, and streak; create captions and posts for review; import media; and adjust the queue. It does not give an assistant permission to publish a new post without your review.

  • Plan your week: ask for open slots, write captions, and prepare posts for those slots.
  • Manage the queue: inspect scheduled, published, or failed posts; update, delete, or requeue them.
  • Build a simple video: use render_video to make a vertical video from scene text, your images or clips, subtitles, and optional licensed audio. ClipHabit renders it on its servers. It does not generate new footage like Sora or Veo.
  • Bring in generated media: import a video or image from a public URL, such as an output from Sora or Veo.
  • Use local creation tools: Claude Code, Codex CLI, and Gemini CLI can run video tools on your own machine, such as Remotion or ffmpeg, then upload the resulting file with create_upload.

Connect your client

Claude on the web or desktop

  1. For an individual Claude Pro or Max account, open Customize > Connectors, select +, then Add custom connector. For Team or Enterprise, an owner first adds a custom web connector in organization settings.
  2. Enter https://app.cliphabit.com/mcp as the remote MCP URL and add the connector.
  3. Choose Connect, complete ClipHabit OAuth, then enable the connector for your conversation. Your Claude account must support custom connectors.

Claude Code

  1. Run this command in a terminal:
claude mcp add --transport http cliphabit https://app.cliphabit.com/mcp

Start Claude Code, enter /mcp, select ClipHabit, and follow the browser sign-in flow. Check that the server shows as connected.

ChatGPT

  1. On ChatGPT web, open Settings > Security and login and turn on Developer mode.
  2. Open ChatGPT Plugins, select the plus button, and create a developer-mode app using https://app.cliphabit.com/mcp as the remote MCP URL. Choose OAuth and complete authorization.
  3. In a chat, choose Developer mode from the Plus menu and select the ClipHabit app. Review confirmation prompts for write actions.

OpenAI documents Developer mode with read and write MCP tools for ChatGPT Plus, Pro, Business, Enterprise, and Education accounts on the web. Workspace controls and availability can still affect your setup.

Gemini CLI

Add this entry to your user ~/.gemini/settings.json, preserving other settings already in the file:

{
  "mcpServers": {
    "cliphabit": {
      "httpUrl": "https://app.cliphabit.com/mcp"
    }
  }
}

Restart Gemini CLI. When prompted, complete OAuth in your browser. If needed, use /mcp auth cliphabit to start authentication, then inspect the available tools with /mcp.

Codex CLI

  1. Add the remote server:
codex mcp add cliphabit --url https://app.cliphabit.com/mcp
codex mcp login cliphabit
codex mcp list

The login command starts OAuth in your browser. If your installation or workspace has MCP restrictions, check your Codex settings.

Available MCP tools

  • whoamiWorkspace, plan, limits, and usage.
  • list_accountsConnected TikTok accounts.
  • get_queueScheduled, published, and failed posts, filtered by account or date.
  • get_streakCurrent and record posting streak for each account.
  • get_slots / set_slotsRead or change recurring time slots per account.
  • create_uploadGet a signed upload URL and media ID for a local file.
  • import_media_from_urlImport a video or image from a public URL and return its media ID.
  • create_postPrepare a direct or draft post with media, caption, time, and AI disclosure. Returns an approval URL.
  • update_post / delete_post / requeue_postEdit, remove, or reschedule queued posts.
  • list_templates / create_templateReuse or save caption and hashtag templates.
  • get_best_timesGet posting time suggestions based on your account data when available, otherwise labeled starter suggestions.
  • render_videoRender a 1080 x 1920 vertical video from a JSON scene specification. Pro and Agency.
  • get_renderCheck rendering progress and retrieve the finished video as ClipHabit media. Pro and Agency.

ClipHabit also provides the plan_week MCP prompt. It helps plan a week of content around open slots. These tools are available on ClipHabit Pro and Agency plans.

Prompts to try

  • "Show my open slots next week, then plan five videos with draft captions. Ask me to approve each post."
  • "Find failed posts from this week and tell me what needs attention."
  • "Import this video from a public URL, mark it as AI-generated, and prepare it for my Friday slot."
  • "Using the video file I just rendered locally, upload it and prepare a draft post for review."

Create a video from chat

On Pro and Agency, the video builder turns a JSON specification of scenes into a 1080 x 1920 video. Scenes can use text, a color background, an image or clip from a URL, duration, simple transitions, and subtitles. You may add audio from a URL if you have the rights to use it. ClipHabit downloads the supplied assets and renders the video with ffmpeg on its servers. The finished file becomes normal ClipHabit media and is marked AI-generated by default.

For example, give your assistant this prompt:

"Create a 15-second vertical video for Friday's TikTok slot. Use three 5-second scenes: a title on a solid background, my image at https://example.com/my-photo.jpg with a short caption, and a final call to action. Add subtitles. Use no audio. Render it with ClipHabit, check when it is ready, then prepare a draft post for my approval."

The assistant sends the scene specification to render_video, checks progress with get_render, then uses the resulting media with create_post. Open the returned approval_url to review the video and TikTok settings before it enters the queue. A chat assistant can direct this workflow, but it does not create new footage like a generative video model.

Your approval is required

Every post created by an assistant starts in needs_approval. The tool returns an approval_url. Open that URL in ClipHabit to review the media and caption, choose the TikTok privacy setting, manage comment/duet/stitch settings, disclose commercial or AI-generated content when applicable, and confirm music usage before the post enters the queue.

Choose Direct post to publish through TikTok's official Content Posting API, or Send to TikTok drafts to finish in the TikTok app, including adding a sound. The TikTok API does not let ClipHabit add music library sounds for you.