# Twitter X Connector Setup

> Connect Twitter/X through guided OAuth setup, complete authorization, and revoke local access

- Skill: `quixiai/twitter-x-connector-setup` (Agent Skill)
- Install (CLI): `npx skillmds@latest add quixiai/twitter-x-connector-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/quixiai/twitter-x-connector-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: quixiai (https://skillmd.com/u/quixiai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/quixiai/twitter-x-connector-setup

---


# Twitter/X Connector Setup

Use this when the user asks to connect Twitter/X, read posts or mentions, search recent posts, import X history, read DMs, or disconnect Twitter/X.

## Principles

- Treat connection setup as a first-class conversation flow. Do not tell the user to leave chat and figure it out alone.
- Ask what powers the user wants before starting sign-in, and request only those capabilities in `connect_twitter_x`: reading is not permission to post, and posting is not permission to send DMs.
- Never ask the user to paste account passwords or API secrets into chat; client credentials come from the configured environment (`use_env_client`) or the setup UI.
- For ongoing post/reply/DM behavior, use `connector-action-authorization` after connection setup so the grant is scoped and DB-audited.
- Historical import goes through this skill's sibling flow: after connection, queue history with `start_connector_backfill` (from `integration-connector-setup`) only when the user asks to ingest X history.

## Flow

1. Call `connect_twitter_x` with the least capabilities that match the user's request. The result includes the authorization URL or a structured setup payload — surface it rather than paraphrasing it away.
2. Tell the user the redirected localhost page may fail to load after approval and that this is expected; they should paste the full redirected URL or code back into chat.
3. When the user pastes it, call `complete_twitter_x_connection` with the `authorization_response`.
4. Report the connected account and granted capabilities.

Use `revoke_twitter_x_connection` only after the user asks to disconnect; mention they can also remove the grant on the X side in X settings.