# Connect ClipHabit to Claude, ChatGPT and Gemini

ClipHabit Pro and Agency include an OAuth 2.1 remote MCP server at `https://app.cliphabit.com/mcp`. It lets compatible AI assistants plan TikTok posts, write captions, inspect and manage the queue, import media, render simple vertical videos with the ClipHabit video builder, and create posts for user approval. The video builder is also available through the API.

## Connect Claude on web or desktop

Individual Claude Pro or Max: Customize > Connectors > + > Add custom connector. Enter the ClipHabit MCP endpoint, add, connect, and complete OAuth. On Team or Enterprise, an owner first adds the custom web connector in organization settings. Enable the connector in the conversation.

## Connect Claude Code

```sh
claude mcp add --transport http cliphabit https://app.cliphabit.com/mcp
```

Run `/mcp` in Claude Code, sign in through the browser, and check the connection.

## Connect ChatGPT

On ChatGPT web, open Settings > Security and login and turn on Developer mode. In ChatGPT Plugins, select the plus button, create a developer-mode app with the ClipHabit endpoint, choose OAuth, and connect. In a chat, choose Developer mode from the Plus menu and select ClipHabit. OpenAI documents read and write MCP tools on ChatGPT Plus, Pro, Business, Enterprise, and Education accounts. Workspace controls may apply. Review write action confirmations.

## Connect Gemini CLI

Add to `~/.gemini/settings.json`, retaining existing settings:

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

Restart Gemini CLI, complete OAuth, and use `/mcp auth cliphabit` if sign-in is needed.

## Connect Codex CLI

```sh
codex mcp add cliphabit --url https://app.cliphabit.com/mcp
codex mcp login cliphabit
codex mcp list
```

## Tools

- `whoami`: workspace, plan, limits, and usage.
- `list_accounts`: connected TikTok accounts.
- `get_queue`: scheduled, published, and failed posts, with filters.
- `get_streak`: current and record streak per account.
- `get_slots` and `set_slots`: recurring times per account.
- `create_upload`: signed upload URL and media ID for a local file.
- `import_media_from_url`: import public video or image URL.
- `create_post`: prepare a direct or draft post and return an approval URL.
- `update_post`, `delete_post`, `requeue_post`: manage posts.
- `list_templates`, `create_template`: manage caption and hashtag templates.
- `get_best_times`: metric-based suggestions if enough data exist, otherwise labeled generic starter times.
- `render_video`: render a 1080 x 1920 vertical video from a JSON scene specification on ClipHabit's servers (Pro and Agency).
- `get_render`: check render progress and retrieve the finished video as ClipHabit media (Pro and Agency).
- `plan_week`: MCP prompt to plan content using open slots.

## Real workflows and approval

Ask an assistant to find open slots, plan a week, draft captions, and prepare posts. It can also call `render_video` and `get_render` to make a simple vertical video with scene text, color or image or clip backgrounds, simple transitions, and subtitles. ClipHabit renders it with ffmpeg on its servers. Provide any optional audio by URL and make sure you have a license to use it. The finished video becomes ClipHabit media and is marked AI-generated by default. The assistant does not generate new footage like Sora or Veo. You can also import externally generated media from a public URL. File-capable clients such as Claude Code, Codex CLI, and Gemini CLI can run Remotion or ffmpeg locally and upload the output.

Example prompt: "Create a 15-second vertical video for Friday's slot with three scenes: a title on a solid background, my image at https://example.com/my-photo.jpg with a caption, and a final call to action. Add subtitles, use no audio, render it with ClipHabit, check the result, and prepare a draft post for my approval." The assistant calls `render_video`, checks `get_render`, then uses the resulting media with `create_post` and returns the `approval_url`.

Every MCP-created post starts in `needs_approval`. Open its `approval_url` in ClipHabit, review the media and caption, choose TikTok privacy and creator settings, give required consents, and mark AI-generated content when applicable. Only after approval does it enter the queue. Choose Direct post or Send to TikTok drafts; draft mode lets you add TikTok library sounds in the TikTok app.

[Home and pricing](https://cliphabit.com/) | [Privacy](https://cliphabit.com/privacy/) | [Terms](https://cliphabit.com/terms/) | hello@cliphabit.com
