Penpot
Open-source design and prototyping platform for collaborative design workflows
This is a first-class FlyMyAI MCP. Agents discover it automatically via tool search and call the actions below on demand - you never wire it up by hand. See the Composio catalog for how discovery works.
Connect
Penpot authenticates with an API key. Generate the credential in your Penpot account, then paste it into FlyMyAI the first time an agent uses a Penpot action.
Fields to fill in FlyMyAI
| Field | Details |
|---|---|
Penpot API Base URL | Your Penpot instance API base URL. Example: https://design.penpot.app/api (for cloud) or https://your-domain.com/api (for self-hosted) (required) |
Access Token | Access token from Your account → Access tokens in Penpot profile settings (required) |
Actions
Every action this integration exposes. Agents pick the right one from the task; you do not call them by name.
| Action | What it does | Required inputs |
|---|---|---|
PENPOT_CREATE_ACCESS_TOKEN | Tool to create a personal access token for API authentication in Penpot. Use when you need to generate a new token for authenticating API requests. The token will only be shown once during creation, so it should be stored securely. | name |
PENPOT_CREATE_COMMENT_THREAD | Tool to create a new comment thread on a Penpot file at a specific position. Use when you need to add collaborative feedback or discussion points on design elements within a Penpot project. | fileId, pageId, frameId, position, content |
PENPOT_CREATE_FILE | Tool to create a new design file in a Penpot project. Use when you need to create a new file for design work within a specific project. | name, project_id |
PENPOT_CREATE_PROJECT | Tool to create a new project within a team in Penpot. Use when you need to organize design files into a new project space. | team_id, name |
PENPOT_CREATE_TEAM | Tool to create a new team in Penpot. Use when you need to set up a new team for organizing projects and collaborating with team members. | name |
PENPOT_CREATE_TEAM_ACCESS_REQUEST | Tool to request an invitation to join a Penpot team. Use when a user needs to request access to a team for collaboration. | team_id |
PENPOT_CREATE_WEBHOOK | Create a webhook for a team to receive event notifications. Use when you need to register a new webhook endpoint that will be notified of events happening in a Penpot team. | team_id, uri, mtype |
PENPOT_DELETE_ACCESS_TOKEN | Tool to delete a personal access token from Penpot. Use when you need to revoke or remove an existing access token by its UUID. | id |
PENPOT_DELETE_COMMENT | Tool to delete a comment from a Penpot design file. Use when you need to permanently remove a specific comment from a design discussion. | id |
PENPOT_DELETE_FILE_SNAPSHOT | Tool to delete a file snapshot in Penpot. Use when you need to remove a previously created snapshot from a file. | id |
PENPOT_DELETE_PROJECT | Tool to delete a project from Penpot. Use when you need to permanently remove a project and all its contents. | id |
PENPOT_DELETE_TEAM | Tool to delete a team from Penpot. Use when you need to permanently remove a team. This operation is irreversible. | id |
PENPOT_DELETE_TEAM_FILES_PERMANENTLY | Tool to permanently delete specified files from a Penpot team. Use when you need to immediately and irreversibly remove files from a team. The team ID is used to filter files and verify write permissions. | team_id, ids |
PENPOT_DELETE_TEAM_INVITATION | Tool to delete a pending team invitation in Penpot. Use when you need to cancel an invitation that hasn't been accepted yet. | team_id, email |
PENPOT_DELETE_TEAM_MEMBER | Tool to remove a member from a team in Penpot. Use when you need to revoke a user's access to a team. | team_id, member_id |
PENPOT_DELETE_WEBHOOK | Tool to delete a webhook by its UUID. Use when you need to remove a webhook from Penpot. | id |
PENPOT_DUPLICATE_FILE | Tool to duplicate a single file within the same team in Penpot. Use when you need to create a copy of an existing design file. | fileId |
PENPOT_DUPLICATE_PROJECT | Tool to duplicate an entire Penpot project with all its files. Use when you need to create a copy of an existing project. | projectId |
PENPOT_GET_ACCESS_TOKENS | Tool to list all personal access tokens for the authenticated user. Use when you need to view, audit, or manage existing access tokens. | - |
PENPOT_GET_ALL_PROJECTS | Tool to retrieve all projects across all teams in Penpot. Use when you need a complete list of projects regardless of team membership. | - |
PENPOT_GET_BUILTIN_TEMPLATES | Tool to get the list of builtin templates available in Penpot. Use when you need to see which templates are available for creating new projects. | - |
PENPOT_GET_COMMENTS | Tool to retrieve all comments in a comment thread. Use when you need to fetch all comments from a specific thread. | thread_id |
PENPOT_GET_COMMENT_THREAD | Tool to retrieve a specific comment thread from a Penpot file. Use when you need to fetch details about a comment thread including its comments, participants, and metadata. | file_id, id |
PENPOT_GET_COMMENT_THREADS | Tool to retrieve all comment threads for a Penpot file. Use when you need to fetch comments and discussions associated with a specific file. | file_id |
PENPOT_GET_FILE | Tool to retrieve a Penpot file by its ID. Returns file details including metadata, structure, and permissions. Use when you need to access file information or check file properties. | id |
PENPOT_GET_FILE_INFO | Tool to retrieve basic information about a Penpot file by its ID. Use when you need to get file metadata such as name, project, creation date, modification date, version, and sharing status. | id |
PENPOT_GET_FILE_LIBRARIES | Tool to retrieve libraries linked to a Penpot file. Use when you need to get all library references associated with a specific file by its UUID. | fileId |
PENPOT_GET_FILE_OBJECT_THUMBNAILS | Tool to retrieve thumbnails for objects in a Penpot file. Use when you need to get thumbnail URLs for file objects. | file_id |
PENPOT_GET_FILE_SNAPSHOTS | Retrieves all snapshots for a specific Penpot file. Use this action to list all saved versions (snapshots) of a file, which allows viewing version history and understanding how the file has evolved over time. Snapshots capture the state of a file at specific… | fileId |
PENPOT_GET_FILE_SUMMARY | Tool to retrieve a summary of file contents and statistics from Penpot. Use when you need high-level information about a file including page count, components, graphics, and other metadata without fetching the entire file content. | id |
PENPOT_GET_FONT_VARIANTS | Tool to retrieve font variants for a team, file, project, or share in Penpot. Use when you need to get a list of available font variants. Provide at least one of team_id, file_id, project_id, or share_id to scope the query. | - |
PENPOT_GET_LIBRARY_FILE_REFERENCES | Tool to get files that reference a shared library. Use when you need to find which files are using a specific library file in Penpot. | fileId |
PENPOT_GET_LIBRARY_USAGE | Tool to get usage statistics for a library. Returns the number of files that use the specified library. Use when you need to understand how widely a library is being used across projects. | fileId |
PENPOT_GET_OWNED_TEAMS | Tool to list teams owned by the current user. Use when you need to retrieve teams that the authenticated user owns in Penpot. | - |
PENPOT_GET_PAGE | Tool to retrieve page data from a Penpot file. Use when you need to get page content including objects and metadata for rendering or export purposes. If no page ID is specified, returns the first page. Can filter to a specific object and its children by provi… | fileId |
PENPOT_GET_PROFILES_FOR_FILE_COMMENTS | Tool to retrieve profiles of users who have commented on a Penpot file. Use when you need to get information about comment participants for collaboration or user management purposes. | fileId |
PENPOT_GET_PROJECT | Tool to retrieve detailed information about a specific Penpot project by its ID. Use when you need to get project details such as name, team ownership, and timestamps. | id |
PENPOT_GET_PROJECT_FILES | Tool to retrieve all files in a Penpot project. Use when you need to list all files for a specific project by its UUID. | projectId |
PENPOT_GET_SSO_PROVIDER | Tool to retrieve SSO provider information for an email address. Use when you need to determine which SSO provider is configured for a specific email domain. | email |
PENPOT_GET_SUBSCRIPTION_USAGE | Tool to get subscription usage information for the current user. Returns details about seats and storage usage. Use when you need to check subscription limits or current usage statistics. | - |
PENPOT_GET_TEAM | Tool to retrieve team details by ID. Use when you need to fetch information about a specific team in Penpot. | id |
PENPOT_GET_TEAMS | Tool to list all teams the authenticated user is a member of. Use when you need to retrieve teams where the user has membership in Penpot. | - |
PENPOT_GET_TEAM_DELETED_FILES | Tool to retrieve deleted files from a team's trash in Penpot. Use when you need to view files that have been deleted from a specific team and are in the trash. | teamId |
PENPOT_GET_TEAM_INFO | Tool to retrieve detailed information about a specific Penpot team by its ID. Use when you need to get team details such as name, creation date, and permissions. | id |
PENPOT_GET_TEAM_INVITATIONS | Tool to list pending invitations for a team in Penpot. Use when you need to retrieve all pending team invitations that haven't been accepted yet. | team_id |
PENPOT_GET_TEAM_MEMBERS | Tool to list all members of a team in Penpot. Use when you need to retrieve team membership information and member details. | team_id |
PENPOT_GET_TEAM_SHARED_FILES | Tool to retrieve shared library files for a Penpot team. Use when you need to list all shared library files for a specific team by its UUID. | teamId |
PENPOT_GET_TEAM_STATS | Tool to retrieve statistics for a specific Penpot team by its ID. Use when you need to get team metrics such as project count, file count, and member count. | team-id |
PENPOT_GET_TEAM_USERS | Tool to retrieve users in a team by team ID or file ID. Use when you need to list team members associated with a specific team or file. | - |
PENPOT_GET_UNREAD_COMMENT_THREADS | Tool to retrieve comment threads with unread comments for a specific team. Use when you need to check for new comments or discussions requiring attention. | team_id |
PENPOT_GET_VIEW_ONLY_BUNDLE | Tool to retrieve data bundle for view-only file access in Penpot. Use when you need to access read-only file data through a share link or for preview purposes. | file_id |
PENPOT_GET_WEBHOOKS | Tool to retrieve all webhooks configured for a team. Use when you need to list existing webhook endpoints registered for a Penpot team. | team_id |
PENPOT_HAS_FILE_LIBRARIES | Tool to check if a Penpot file has linked libraries. Use when you need to determine whether a specific file references any external libraries. | fileId |
PENPOT_IGNORE_FILE_LIBRARY_SYNC_STATUS | Tool to ignore library sync status updates for a file. Use when you need to mark library updates as ignored for a specific file, preventing sync notifications from appearing. | fileId, date |
PENPOT_LINK_FILE_TO_LIBRARY | Tool to link a file to a library in Penpot. Returns the recursive list of libraries used by that library. Use when you need to establish a library reference relationship between a file and a library. | fileId, libraryId |
PENPOT_LOCK_FILE_SNAPSHOT | Tool to lock a file snapshot in Penpot to prevent deletion. Use when you need to protect a snapshot from being removed. | id |
PENPOT_LOGOUT | Tool to clear the authentication cookie and logout the current session. Use when the authenticated user wants to end their Penpot session and invalidate their authentication. | - |
PENPOT_MARK_ALL_THREADS_AS_READ | Tool to mark all comment threads as read in Penpot. Use when you need to clear unread status for comment threads. | threads |
PENPOT_MOVE_FILES | Tool to move files from one project to another in Penpot. Use when you need to reorganize files by transferring them between projects. | ids, project_id |
PENPOT_MOVE_PROJECT | Tool to move a project to a different team in Penpot. Use when you need to transfer a project from one team to another. | project_id, team_id |
PENPOT_PREPARE_REGISTER_PROFILE | Tool to prepare user registration by validating email and sending verification in Penpot. Use when you need to initiate the registration process for a new user. This endpoint validates the provided information and typically sends a verification email to compl… | fullname, email, password |
PENPOT_PUSH_AUDIT_EVENTS | Tool to push audit events to Penpot for tracking system behavior and user actions. Use when you need to log important events like user actions, file changes, or team modifications for auditing purposes. | events |
PENPOT_REGISTER_PROFILE | Tool to complete user registration with profile details using a verification token. Use when you have a registration token from the prepare-register-profile endpoint and need to finalize the user account creation. | token |
PENPOT_RENAME_FILE | Tool to rename a design file in Penpot. Use when you need to change the name of an existing file. | id, name |
PENPOT_RENAME_PROJECT | Tool to rename an existing project in Penpot. Use when you need to update a project's name. | id, name |
PENPOT_REQUEST_PROFILE_RECOVERY | Tool to request a password/profile recovery email. Use when a user has forgotten their password and needs to initiate the account recovery process. An email with a recovery token will be sent to the specified address. | email |
PENPOT_RESTORE_DELETED_TEAM_FILES | Tool to restore deleted files in a Penpot team. Use when you need to remove the deletion mark from files and projects that are in the team's trash. | team_id, ids |
PENPOT_RESTORE_FILE_SNAPSHOT | Tool to restore a Penpot file to a previous snapshot. Use when you need to revert a file to a previously saved version from its history. | fileId, id |
PENPOT_SEARCH_FILES | Tool to search for files by name or content in a Penpot team. Use when you need to find specific files within a team using a search term. | teamId |
PENPOT_SEND_USER_FEEDBACK | Tool to send user feedback to Penpot. Use when you need to submit feedback, bug reports, feature requests, or error reports to the Penpot team. | subject, content |
PENPOT_SET_FILE_SHARED | Tool to set file sharing status in Penpot (enable/disable shared library). Use when you need to make a file available as a shared library or revoke its shared status. | id, is_shared |
PENPOT_UNLINK_FILE_FROM_LIBRARY | Tool to unlink a file from a shared library in Penpot. Use when you need to remove the library reference relationship between a file and a library. | fileId, libraryId |
PENPOT_UNLOCK_FILE_SNAPSHOT | Tool to unlock a locked file snapshot in Penpot. Use when you need to unlock a previously locked snapshot. | id |
PENPOT_UPDATE_COMMENT | Tool to update the content of an existing comment in a Penpot design file. Use when you need to modify comment text or update mentioned users in a design discussion. | id, content |
PENPOT_UPDATE_COMMENT_THREAD | Tool to update the resolution status of a comment thread in Penpot. Use when you need to mark a comment thread as resolved or unresolved to track discussion progress. | id, isResolved |
PENPOT_UPDATE_COMMENT_THREAD_FRAME | Tool to update the frame associated with a comment thread in Penpot. Use when you need to move a comment thread to a different frame or reposition it within the design hierarchy. | id, frameId |
PENPOT_UPDATE_COMMENT_THREAD_POSITION | Tool to update the position of a comment thread in Penpot. Use when you need to move or reposition an existing comment thread to a different location on the design canvas. | id, position, frameId |
PENPOT_UPDATE_COMMENT_THREAD_STATUS | Tool to update the status of a comment thread in Penpot (e.g., toggle resolved/unresolved). Use when you need to mark a comment thread as resolved or reopen a resolved thread. | id |
PENPOT_UPDATE_FILE | Tool to update a Penpot file with changes. Use when you need to apply modifications to a file such as adding/modifying/deleting objects, pages, colors, components, or other design elements. Requires file ID, session ID, revision number, and version number for… | id, sessionId, revn, vern |
PENPOT_UPDATE_FILE_LIBRARY_SYNC_STATUS | Tool to update the synchronization status of a file->library link. Use when you need to refresh or update the sync status between a file and its linked library. | fileId, libraryId |
PENPOT_UPDATE_FILE_SNAPSHOT | Tool to update a file snapshot metadata in Penpot. Use when you need to modify the label of an existing snapshot. | id, label |
PENPOT_UPDATE_FONT | Tool to update a font's metadata in Penpot. Use when you need to modify the name or other properties of an existing font in a team. | team_id, id, name |
PENPOT_UPDATE_PROFILE | Tool to update the current authenticated user's profile information. Use when you need to change the user's full name, language preference, or theme settings. | fullname |
PENPOT_UPDATE_PROFILE_NOTIFICATIONS | Tool to update notification settings for the authenticated user's profile. Use when you need to configure how the user receives notifications about comments and invitations. | dashboard_comments, email_comments, email_invites |
PENPOT_UPDATE_PROFILE_PROPS | Tool to update custom properties for the authenticated user's profile. Use when you need to modify user preferences such as onboarding status, notification settings, newsletter subscriptions, or plugin configurations. | props |
PENPOT_UPDATE_PROJECT_PIN | Tool to update the pin status of a project in Penpot. Use when you need to pin or unpin a project for quick access. | team_id, id, is_pinned |
PENPOT_UPDATE_TEAM | Tool to update team settings in Penpot. Use when you need to modify team name or other team properties. | id, name |
PENPOT_UPDATE_TEAM_INVITATION_ROLE | Tool to update the role of a pending team invitation in Penpot. Use when you need to change the role of an invitation that hasn't been accepted yet. | team_id, email, role |
PENPOT_UPDATE_WEBHOOK | Tool to update an existing webhook configuration. Use when you need to modify the URI, MIME type, or active status of a webhook. | id, uri, mtype, is_active |
PENPOT_VERIFY_TOKEN | Tool to verify an authentication or registration token in Penpot. Use when you need to validate a token received from registration, email verification, or other authentication flows. | token |
Links
We love our partners - FlyMy.AI builds with the best. Thanks, Penpot!