Can I use Pinterest as a CLI?

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

Can I expose Pinterest through MCP?

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

Where are Pinterest credentials stored?

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

Can I deny write access for Pinterest MCP tools?

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

marketing

Pinterest MCP, CLI, and Lua Integration for AI Agents

Pinterest integration docs for AI agents: MCP gateway setup, Pinterest CLI commands, Lua API reference, credentials, and function schemas.

7 functions 6 read 1 write Manual OAuth token auth

Submit Pinterest feedback View package source

Pinterest for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: pinterest
route_slug: pinterest
package: pinterest
auth_strategy: oauth2_manual_token Manual OAuth token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. Pinterest CLIHeadless setup and direct function calls. Pinterest MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Pinterest MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Pinterest.

Pinterest CLI Matrix

Use these pages for direct Pinterest CLI workflows in scripts, CI, cron, and agent wrappers.

CI Pinterest CLI for CI. Cron Jobs Pinterest CLI for cron jobs. Shell Scripts Pinterest CLI for shell scripts. Headless Automation Pinterest CLI for headless automation. Coding Agents Pinterest CLI for coding agents.

Function Catalog

Function	Type	Parameters	Description
`pinterest.pinterest_create_pin`	Write `write`	6	Create a new pin on a Pinterest board. Provide the board ID, title, description, and image URL. Optionally include a destination link.
`pinterest.pinterest_get_board`	Read `read`	1	Get details of a specific Pinterest board by its ID. Returns the board name, description, pin count, and privacy settings.
`pinterest.pinterest_get_current_user`	Read `read`	0	Get the currently authenticated Pinterest user profile. Returns the username, account type, and profile image.
`pinterest.pinterest_get_pin`	Read `read`	1	Get details of a specific Pinterest pin by its ID. Returns the pin title, description, image, board, and link.
`pinterest.pinterest_list_boards`	Read `read`	2	List boards for the authenticated Pinterest user. Supports pagination with bookmark cursor and page size. Returns board IDs, names, descriptions, and pin counts.
`pinterest.pinterest_list_campaigns`	Read `read`	3	List ad campaigns for a Pinterest ad account. Requires an ad account ID. Supports pagination with bookmark cursor and page size.
`pinterest.pinterest_list_pins`	Read `read`	2	List pins for the authenticated Pinterest user. Supports pagination with bookmark cursor and page size. Returns pin IDs, titles, descriptions, and media.