Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Penpot

Scalekit connector
Open markdown

The Penpot connector lets your AI agent act in each user's Penpot account. Each user connects their own Penpot API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.

Tools
60
What they doRead · write · destructive
26 · 24 · 1026 read24 write10 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Penpot connection

    In AgentKit > Connections, create a Penpot connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'penpot'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Penpot:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'penpot_comment_threads_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Penpot credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • penpot_comment_thread_getGet one comment thread of a file.Read-only

    Get Comment Thread

    Get one comment thread of a file. Returns its page, position, status, owner and first comment. Use this when you know the thread ID.

    Inputs

    file_idstringrequired
    ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
    idstringrequired
    ID (UUID) of the comment thread. Example: c6822969-a5ed-81c9-8008-f4ecb2349795.
    share_idstring
    Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.
  • penpot_comment_threads_listList the comment threads of a file, or of every file in a team.Read-only

    List Comment Threads

    List the comment threads of a file, or of every file in a team. Returns per thread its ID, page, position, status (resolved), owner, first comment and comment count. Use this to review feedback. Use penpot_comments_list for a thread's replies.

    Inputs

    file_idstring
    ID (UUID) of the file. Give this or team_id. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
    share_idstring
    Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.
    team_idstring
    ID (UUID) of the team, to list threads across all its files. Give this or file_id. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
  • penpot_comments_listList the comments of one thread.Read-only

    List Thread Comments

    List the comments of one thread. Returns per comment its ID, content, owner, mentions and dates. Use this to read a discussion.

    Inputs

    thread_idstringrequired
    ID (UUID) of the comment thread. Example: c6822969-a5ed-81c9-8008-f4ecb2349795.
    share_idstring
    Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.
  • penpot_deleted_files_listList a team's files that are marked for deletion and can still be restored.Read-only

    List Deleted Files

    List a team's files that are marked for deletion and can still be restored. Returns per file its ID, name, project and deletion date. Use this before penpot_deleted_files_restore.

    Inputs

    team_idstringrequired
    ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
  • penpot_file_get_infoGet minimal information about one file.Read-only

    Get File Info

    Get minimal information about one file. Returns its ID, name, project ID, team ID and revision. Use this to resolve a file ID cheaply.

    Inputs

    idstringrequired
    ID (UUID) of the file. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
  • penpot_file_libraries_listList the shared libraries a file uses.Read-only

    List File Libraries

    List the shared libraries a file uses. Returns per library its ID, name and sync status. Use this to see a file's design system dependencies.

    Inputs

    file_idstringrequired
    ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
  • penpot_file_snapshots_listList the saved versions (snapshots) of a file.Read-only

    List File Versions

    List the saved versions (snapshots) of a file. Returns per version its ID, label, creation date, author and whether it is pinned. Use this before restoring a version.

    Inputs

    file_idstringrequired
    ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
  • penpot_file_stats_getGet aggregate statistics for one file.Read-only

    Get File Stats

    Get aggregate statistics for one file. Returns page count, shape counts by type and library asset counts. Use this to size up a design file.

    Inputs

    idstringrequired
    ID (UUID) of the file. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.