# Hogmatix integrations

Hogmatix (https://hogmatix.com) is a social media scheduler for X, TikTok, YouTube and Instagram.
AI assistants connect to Hogmatix through its remote MCP server. They can list your connected
accounts, show your scheduled posts and your posting allowance, and schedule or cancel posts on X,
TikTok and YouTube. Instagram scheduling is available on hogmatix.com only, not through AI
assistants.

- MCP server URL: `https://hogmatix.com/mcp`
- Sign-in: OAuth on hogmatix.com. You never give an assistant a password or an API key.
- You need a Hogmatix account with a verified email address (the free plan works; a subscription
  raises your limits), and at least one X, TikTok or YouTube account connected on hogmatix.com.
  You connect and disconnect social accounts on hogmatix.com, not in the assistant.
- Full reference: every tool with its parameters, the sign-in flow, limits and errors are in the
  MCP server documentation at https://hogmatix.com/docs/mcp.

## Supported assistants

| Assistant | Where it works | How to add it | Photos and videos |
|---|---|---|---|
| ChatGPT | Web, desktop and mobile apps | Install from ChatGPT's plugin directory | Attach the file in the chat |
| Claude | claude.ai, Claude Desktop, Claude mobile | Settings > Connectors > Add custom connector | Claude gives you a one-time upload link |
| Claude Code | Terminal | `claude mcp add` | Uploads files from your computer |
| Codex | Codex CLI, Codex IDE extension, ChatGPT desktop app | `codex mcp add`, then `codex mcp login` | Uploads files from your computer |
| Grok | grok.com | Connectors > New Connector > Custom | Text posts only; upload media on hogmatix.com |

## ChatGPT

1. Open Hogmatix in ChatGPT's plugin directory:
   https://chatgpt.com/plugins/plugin_asdk_app_6ac2aaa7dcbc81918086cac62435c144
2. Choose **Install plugin**. ChatGPT sends you to hogmatix.com. Sign in and choose **Allow**.
3. Ask, for example: "Show my connected social accounts and upcoming posts."

To schedule a photo or video, attach it in the chat. Hogmatix copies it into its private storage
first, which can take a moment for a large video. If an attachment from a ChatGPT mobile app
doesn't come through, attach it again on the web.

## Claude (web, Desktop and mobile)

1. In Claude on the web or in Claude Desktop, open **Settings > Connectors** and choose **Add
   custom connector**.
2. Name it Hogmatix and enter `https://hogmatix.com/mcp`.
3. Claude sends you to hogmatix.com. Sign in, check that the request returns to claude.ai, and
   choose **Allow**.
4. In a chat, turn Hogmatix on in the tools menu. A connector added on the web or in Claude
   Desktop is also available in the Claude mobile app.

Claude can't pass files you attach in the chat to Hogmatix. When you ask it to post a photo or
video, it gives you a one-time upload link on hogmatix.com. Full guide:
https://hogmatix.com/claude

## Claude Code

```
claude mcp add --transport http hogmatix https://hogmatix.com/mcp
```

Then run `/mcp` in Claude Code, choose hogmatix and sign in on hogmatix.com.

## Codex

```
codex mcp add hogmatix --url https://hogmatix.com/mcp
codex mcp login hogmatix
```

Or add it to `~/.codex/config.toml` and then run `codex mcp login hogmatix`:

```toml
[mcp_servers.hogmatix]
url = "https://hogmatix.com/mcp"
```

The Codex CLI, the Codex IDE extension and the ChatGPT desktop app share this configuration.

## Grok

1. Go to https://grok.com/connectors, choose **New Connector**, then **Custom**.
2. Enter `https://hogmatix.com/mcp`.
3. Sign in on hogmatix.com when Grok asks, and choose **Allow**. Allow pop-ups from grok.com if
   the sign-in window doesn't open.

## What an assistant can and can't do

It can:

- list your connected X, TikTok and YouTube accounts, your scheduled and recent posts, and your
  plan and posting allowance;
- schedule X posts, threads and long posts, optionally with one image or video;
- schedule TikTok videos, with every choice TikTok requires: privacy, comments, Duet, Stitch,
  disclosure and the AI-generated label;
- schedule YouTube videos with the title, description, visibility and made-for-kids setting;
- cancel a post that hasn't been published yet;
- upload or import media for those posts.

It can't:

- connect or disconnect social accounts;
- post to Instagram;
- change your plan or billing;
- delete a post that is already live on a platform.

Posts must be scheduled at least 10 minutes ahead. A well-behaved assistant confirms the account,
the exact text and the time with you before it schedules anything.

## Technical reference for developers and AI agents

- **Endpoint:** `https://hogmatix.com/mcp`, Streamable HTTP (`POST`), stateless, JSON responses.
  A request without a token gets `401` with a `WWW-Authenticate` header that points to the
  protected-resource metadata.
- **Authorization:** OAuth authorization code flow with PKCE (`S256`).
  - Dynamic client registration: `https://hogmatix.com/register`.
  - Public clients (`token_endpoint_auth_method: none`) and confidential clients
    (`client_secret_post`).
- **Metadata:**
  - `https://hogmatix.com/.well-known/oauth-authorization-server`
  - `https://hogmatix.com/.well-known/oauth-protected-resource/mcp`
- **Scopes:**
  - `hogmatix:read`: "See your connected X, TikTok and YouTube accounts, your scheduled posts and
    your plan".
  - `hogmatix:schedule`: "Upload media and schedule or cancel posts on your connected accounts".
- **Tokens:** access tokens expire after 1 hour, refresh tokens after 60 days. Revoke at
  `https://hogmatix.com/revoke`.
- **Tools** (most clients):
  - read: `list_accounts`, `get_plan`, `get_tiktok_creator_info`, `list_scheduled_posts`,
    `get_upload_status`, `get_import_status`;
  - write: `import_attached_file`, `create_media_upload`, `get_upload_part_url`,
    `complete_media_upload`, `schedule_x_post`, `schedule_tiktok_video`,
    `schedule_youtube_video`, `cancel_scheduled_post`.
- **Claude's hosted connector** gets `create_upload_link` and `get_upload_link_status` instead of
  the import and part-upload tools.
- **Annotations:** every tool carries explicit `readOnlyHint`, `destructiveHint`,
  `idempotentHint` and `openWorldHint` annotations, and the server sends instructions on
  connect.

## Disconnecting

Remove Hogmatix in the assistant's settings. Its access token expires within an hour. To end
every assistant's access to your account at once, email us and we will revoke it.

## Support and policies

- Support: payme@ishti.org (https://hogmatix.com/support.html)
- Privacy Policy, including what assistants receive:
  https://hogmatix.com/privacy.html#ai-assistants
- Terms of Service: https://hogmatix.com/terms.html
