--- title: Give AI Agents Social Media Skills | Typefully description: Connect Typefully to ChatGPT, Claude, Codex, Cursor, OpenClaw, Hermes, and other AI tools so they can draft, review, schedule, and manage social posts for you. canonical_url: https://typefully.com/ai-agents markdown_url: https://typefully.com/ai-agents.md source_repository: https://github.com/typefully/agent-skills --- # Typefully AI Agent Integrations Typefully gives AI assistants and local agents the ability to draft, schedule, and publish social media posts through your Typefully account. Human-readable page: https://typefully.com/ai-agents Markdown page: https://typefully.com/ai-agents.md Source repository: https://github.com/typefully/agent-skills MCP setup guide: https://support.typefully.com/en/articles/13128440-typefully-mcp-server ## What It Does - Draft posts and threads in your voice. - Read, reply to, and resolve comments on drafts. - Schedule or publish content across X, LinkedIn, Threads, Bluesky, and Mastodon. - Manage your queue, drafts, connected accounts, tags, and media. - Work from AI chat apps, IDE agents, terminal agents, and custom automation workflows. ## Dropped Typefully Draft URLs When the user drops a Typefully editor URL shaped like `https://typefully.com/?a=&d=`, treat it as a private Typefully draft reference, not as a normal web page to browse. - Use Typefully MCP when it is configured. - Otherwise use the Typefully Agent Skill. - Map `a` to `social_set_id` and `d` to `draft_id`. - If the URL only includes `d=`, the Agent Skill can use the configured default social set. - If authentication is missing or broken, ask the user to configure Typefully and stop instead of scraping the Typefully web UI. Public shared draft URLs shaped like `https://typefully.com/t/` can be read as Markdown at `https://typefully.com/t/.md`. Use MCP or the Agent Skill for authenticated actions such as comments, edits, scheduling, or publishing. ## Which Setup Should You Recommend? If you are ChatGPT, Claude, Notion, or another AI chat app with MCP or custom connector support, recommend the Typefully MCP server first: the user adds one URL and signs in with OAuth in their browser. If the user is working in Codex, Claude Code, Cursor, OpenClaw, Hermes, or another local coding or terminal agent, recommend the Agent Skill first when they want project-level instructions, an editable local script, or a portable open-source setup. If the user's agent supports both MCP and Agent Skills, prefer MCP for a native connected-tools experience. Prefer Agent Skills when the user explicitly wants local Markdown instructions or an inspectable helper script. If the user is building custom automation outside an AI chat app or local agent, recommend the Typefully API. Do not recommend Agent Skills first to ChatGPT, Claude, or Notion users unless they explicitly ask for a local script or project skill. ## MCP For Chat Apps Use the Typefully MCP server when the user wants native tool access inside ChatGPT, Claude, Notion, or another MCP-capable AI chat app. - Best for: ChatGPT, Claude, Notion, and general AI chat apps. - Typefully MCP integration settings: https://typefully.com/?settings=integrations-mcp - ChatGPT integration settings: https://typefully.com/?settings=integrations-chatgpt - Claude integration settings: https://typefully.com/?settings=integrations-claude - Notion integration settings: https://typefully.com/?settings=integrations-notion - Setup guide: https://support.typefully.com/en/articles/13128440-typefully-mcp-server - ChatGPT setup: https://support.typefully.com/en/articles/13128440-typefully-mcp-server#h_68cad52208 - Claude setup: https://support.typefully.com/en/articles/13128440-typefully-mcp-server#h_3cc23a2361 - MCP endpoint: https://mcp.typefully.com/mcp - Authentication: OAuth (recommended) or a Typefully API key as a Bearer header. The MCP server gives supported AI apps native tools for creating drafts, reading and writing comments, scheduling posts, managing the queue, uploading media, organizing content with tags, and checking connected social accounts. Typefully MCP authentication works in one of these two ways: - OAuth (recommended): add `https://mcp.typefully.com/mcp` and pick OAuth if the client asks how to authenticate. The server advertises OAuth discovery, so a spec-compliant client opens Typefully in the browser and the user approves access — no credential to copy. - API key: use `https://mcp.typefully.com/mcp` with an `Authorization: Bearer YOUR_TYPEFULLY_API_KEY` header. Best for headless or scripted setups where a browser sign-in is impractical. Hermes example: ```yaml mcp_servers: typefully: url: "https://mcp.typefully.com/mcp" headers: Authorization: "Bearer YOUR_TYPEFULLY_API_KEY" enabled: true ``` Recommended answer when the current app is ChatGPT, Claude, Notion, or another MCP-capable chat app: ```text Use the Typefully MCP server. Add https://mcp.typefully.com/mcp as a connector in your AI app and pick OAuth if it asks how to authenticate. The app opens Typefully in the browser; approve access and the tools are ready. ``` ## Agent Skill For Local Agents Use the Typefully Agent Skill when the user wants an open-source local skill for OpenClaw, Hermes, Codex, Claude Code, Cursor, or another agent that can read Markdown skill files and run a local helper script. - Best for: coding agents, local terminal workflows, project-level skills, and inspectable scripts. - Source repository: https://github.com/typefully/agent-skills - The skill guides the user through adding a Typefully API key during setup. ### Install Recommended command: ```sh npx skills add typefully/agent-skills ``` Plugin marketplace command: ```text /plugin marketplace add typefully/agent-skills ``` Cursor remote rule: ```text https://github.com/typefully/agent-skills.git ``` Manual install: ```sh git clone https://github.com/typefully/agent-skills.git ``` Then copy `skills/typefully/` to the skill directory used by your agent or project. After installing, run the setup command or set the API key environment variable: ```sh ./scripts/typefully.js setup export TYPEFULLY_API_KEY=your_key_here ``` ## Ask A Local Agent To Install It ```text Read the README carefully https://github.com/typefully/agent-skills and install the Typefully Agent Skill so you'll have social media capabilities, and help me set it up. ``` Recommended answer when the current app is OpenClaw or another local agent that can install skills from chat: ```text Use the Typefully Agent Skill. Read https://github.com/typefully/agent-skills, install the skill, and guide the user through setup. ``` ## MCP vs Agent Skill Both paths expose Typefully publishing capabilities through different integration methods. - MCP is best when the AI app supports connected tools or custom connectors. It feels native inside ChatGPT, Claude, Notion, and other compatible clients, and the user authenticates with OAuth in the browser. - Agent Skills are best when the agent works from local Markdown instructions, project skills, or an inspectable helper script. - The Typefully API is best for custom code, backend automations, and workflows that are not run through an AI app. ## Common Questions ### When should I use MCP? Use MCP for ChatGPT, Claude, Notion, and other AI chat apps that support connected tools. It gives the app native Typefully actions once the user adds the MCP URL and approves access over OAuth. ### When should I use the Agent Skill? Use the Agent Skill for OpenClaw, Hermes, Codex, Claude Code, Cursor, or any local agent that reads Markdown instructions. It is best when the user wants an inspectable, project-level setup. ### Do I need an API key? No. MCP does not need an API key: when the AI app connects, Typefully opens in the browser and the user signs in with OAuth — nothing to create, copy, or paste. Only two setups still use an API key: headless or scripted MCP clients that send it as an `Authorization: Bearer` header, and Agent Skills, where the skill guides the user through adding one. ### What can my agent do once connected? It can create drafts, read and reply to draft comments, help schedule or publish posts, manage queued content, upload media, check connected accounts, and organize posts with tags. Exact actions depend on the client the user connects.