Can I use Typefully as a CLI?

Yes. KosmoKrator exposes a Typefully CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Typefully through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Typefully tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Typefully credentials stored?

Typefully credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Typefully MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

social-media

Typefully CLI for AI Agents

Use the Typefully CLI from KosmoKrator to call Typefully tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

5 functions 4 read 1 write API key auth

Submit Typefully feedback View package source

Typefully CLI Setup

Typefully can be configured headlessly with `kosmokrator integrations:configure typefully`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure typefully --set api_key="$TYPEFULLY_API_KEY" --enable --read allow --write ask --json
kosmokrator integrations:doctor typefully --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`api_key`	`TYPEFULLY_API_KEY`	Secret `secret`	yes	API Key
`url`	`TYPEFULLY_URL`	URL `url`	no	API Base URL

Call Typefully Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call typefully.typefully_create_draft '{
  "content": "example_content",
  "type": "example_type",
  "schedule_date": "example_schedule_date",
  "thread_connector": true,
  "is_tweet_pin": true,
  "is_tweet_reply": true,
  "reply_to": "example_reply_to",
  "mail_subject": "example_mail_subject"
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:typefully typefully_create_draft '{
  "content": "example_content",
  "type": "example_type",
  "schedule_date": "example_schedule_date",
  "thread_connector": true,
  "is_tweet_pin": true,
  "is_tweet_reply": true,
  "reply_to": "example_reply_to",
  "mail_subject": "example_mail_subject"
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs typefully --json
kosmo integrations:docs typefully.typefully_create_draft --json
kosmo integrations:schema typefully.typefully_create_draft --json
kosmo integrations:search "Typefully" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Typefully.

`typefully.typefully_create_draft`

Write write

Create a new draft in Typefully. Supports tweets, threads, and newsletter drafts. Separate individual tweets in a thread with four newlines (\\n\\n\\n\\n).

Parameters: content, type, schedule_date, thread_connector, is_tweet_pin, is_tweet_reply, reply_to, mail_subject, mail_subtitle, audience_id, label_ids

Generic CLI call

kosmo integrations:call typefully.typefully_create_draft '{"content":"example_content","type":"example_type","schedule_date":"example_schedule_date","thread_connector":true,"is_tweet_pin":true,"is_tweet_reply":true,"reply_to":"example_reply_to","mail_subject":"example_mail_subject"}' --json

Provider shortcut

kosmo integrations:typefully typefully_create_draft '{"content":"example_content","type":"example_type","schedule_date":"example_schedule_date","thread_connector":true,"is_tweet_pin":true,"is_tweet_reply":true,"reply_to":"example_reply_to","mail_subject":"example_mail_subject"}' --json

`typefully.typefully_list_scheduled`

Read read

List scheduled drafts in Typefully that are queued for publication. Returns draft content, scheduled dates, and metadata.

Parameters: limit, offset

Generic CLI call

kosmo integrations:call typefully.typefully_list_scheduled '{"limit":1,"offset":1}' --json

Provider shortcut

kosmo integrations:typefully typefully_list_scheduled '{"limit":1,"offset":1}' --json

`typefully.typefully_list_published`

Read read

List published drafts in Typefully. Returns content, publication dates, engagement metrics, and metadata.

Parameters: limit, offset

Generic CLI call

kosmo integrations:call typefully.typefully_list_published '{"limit":1,"offset":1}' --json

Provider shortcut

kosmo integrations:typefully typefully_list_published '{"limit":1,"offset":1}' --json

`typefully.typefully_get_draft`

Read read

Get details of a specific Typefully draft by its ID. Returns full content, scheduling info, and metadata.

Parameters: id

Generic CLI call

kosmo integrations:call typefully.typefully_get_draft '{"id":"example_id"}' --json

Provider shortcut

kosmo integrations:typefully typefully_get_draft '{"id":"example_id"}' --json

`typefully.typefully_get_current_user`

Read read

Get the authenticated Typefully user's profile information, including handle, name, and account details.

Parameters: none

Generic CLI call

kosmo integrations:call typefully.typefully_get_current_user '{}' --json

Provider shortcut

kosmo integrations:typefully typefully_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`typefully.typefully_create_draft`

Create a new draft in Typefully. Supports tweets, threads, and newsletter drafts. Separate individual tweets in a thread with four newlines (\\n\\n\\n\\n).

Operation: Write write
Schema command: kosmo integrations:schema typefully.typefully_create_draft --json

Parameter	Type	Required	Description
`content`	string	yes	The content of the draft. For threads, separate tweets with four newlines.
`type`	string	no	The type of draft: "tweet", "thread", or "mail". Defaults to auto-detected based on content.
`schedule_date`	string	no	ISO 8601 date to schedule the draft (e.g., "2026-04-10T09:00:00Z"). Omit to save as a draft without scheduling.
`thread_connector`	boolean	no	Whether to add a "Show more" connector between tweets in a thread (default: true).
`is_tweet_pin`	boolean	no	Pin the tweet after publishing (default: false).
`is_tweet_reply`	boolean	no	Publish as a reply (requires reply_to, default: false).
`reply_to`	string	no	Tweet ID to reply to (required if is_tweet_reply is true).
`mail_subject`	string	no	Subject line for newsletter drafts (type "mail" only).
`mail_subtitle`	string	no	Subtitle for newsletter drafts.
`audience_id`	string	no	Typefully audience ID for newsletter drafts.
`label_ids`	array	no	Array of label IDs to assign to the draft.

`typefully.typefully_list_scheduled`

List scheduled drafts in Typefully that are queued for publication. Returns draft content, scheduled dates, and metadata.

Operation: Read read
Schema command: kosmo integrations:schema typefully.typefully_list_scheduled --json

Parameter	Type	Required	Description
`limit`	integer	no	Maximum number of drafts to return (default: 20, max: 100).
`offset`	integer	no	Number of drafts to skip for pagination (default: 0).

`typefully.typefully_list_published`

List published drafts in Typefully. Returns content, publication dates, engagement metrics, and metadata.

Operation: Read read
Schema command: kosmo integrations:schema typefully.typefully_list_published --json

Parameter	Type	Required	Description
`limit`	integer	no	Maximum number of drafts to return (default: 20, max: 100).
`offset`	integer	no	Number of drafts to skip for pagination (default: 0).

`typefully.typefully_get_draft`

Get details of a specific Typefully draft by its ID. Returns full content, scheduling info, and metadata.

Operation: Read read
Schema command: kosmo integrations:schema typefully.typefully_get_draft --json

Parameter	Type	Required	Description
`id`	string	yes	The Typefully draft ID.

`typefully.typefully_get_current_user`

Get the authenticated Typefully user's profile information, including handle, name, and account details.

Operation: Read read
Schema command: kosmo integrations:schema typefully.typefully_get_current_user --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.