Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Fibery MCP connector

OAuth 2.1/DCR Project ManagementProductivity

Connect to Fibery MCP. Query, create, and update entities across your Fibery workspace using the Fibery API and AI assistant.

Fibery MCP connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “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. Authorize and make your first call

    Section titled “Authorize and make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENV_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'fiberymcp'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Fibery MCP:', link)
    process.stdout.write('Press Enter after authorizing...')
    await new Promise(r => process.stdin.once('data', r))
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'fiberymcp_get_connectors_list',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Update workflow field, view, single select fields — Updates the options of an existing workflow (state) field
  • State set — Sets the workflow state of a Fibery entity
  • Content set document, append document — Sets (replaces) the content of a document field on a Fibery entity
  • Search history, guide — Searches the workspace activity history and returns matching history events
  • Detailed schema — Returns detailed schema for specified databases, including fields and related databases
  • Schema records — Returns the high-level workspace structure showing all spaces and databases

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

fiberymcp_add_collection_items # Adds related entities to a Collection field on a Fibery entity. 4 params

Adds related entities to a Collection field on a Fibery entity.

Name Type Required Description
database string required Full database name (e.g., 'SoftDev/Task')
entityId string required fibery/id of an entity
field string required The name of the collection field
items array required An array of related entity ids to add to the collection. Each entry must be fibery/id of the entity to add
fiberymcp_add_comment # Adds a top-level comment or reply to an existing comment on a Fibery entity. 4 params

Adds a top-level comment or reply to an existing comment on a Fibery entity.

Name Type Required Description
content string required Comment content in Markdown format
database string required Full database name (e.g., 'SoftDev/Task'). Must be a database that supports comments (has the comments/comments collection).
entityId string required fibery/id of the entity to comment on
parentCommentId string optional fibery/id of the parent comment when replying. Omit for a top-level comment. The parent comment must belong to the same entity (entityId) — otherwise the request is rejected.
fiberymcp_add_file_from_url # Attaches a file to a Fibery entity by downloading it from a publicly accessible URL. 5 params

Attaches a file to a Fibery entity by downloading it from a publicly accessible URL.

Name Type Required Description
database string required Full database name (e.g., 'SoftDev/Task')
entityId string required fibery/id of an entity
field string required Exact name of a file field on this database (e.g., 'Files/Files' or 'Space/Files'). Confirm via `schema_detailed` tool call. Document fields cannot be used.
fileName string required Name of the file to be added (e.g., 'Report.pdf')
url string required HTTP(s) URL to download the file from
fiberymcp_append_document_content # Appends Markdown content to the end of a document field on a Fibery entity. 4 params

Appends Markdown content to the end of a document field on a Fibery entity.

Name Type Required Description
content string required Document's content in MD format. Any content you write here will be APPENDED to already existing content in the document
database string required Full database name (e.g., 'SoftDev/Task')
entityId string required fibery/id of an entity
field string required The name of the document field
fiberymcp_create_avatars_fields # Enables avatar/profile-picture attachments on entities in one or more databases. 1 param

Enables avatar/profile-picture attachments on entities in one or more databases.

Name Type Required Description
databases array required Array of full database names (e.g., ["SoftDev/Task"])
fiberymcp_create_comments_fields # Enables comments on entities in one or more databases. 1 param

Enables comments on entities in one or more databases.

Name Type Required Description
databases array required Array of full database names (e.g., ["SoftDev/Task"])
fiberymcp_create_databases # Creates one or more new databases within an existing space. 1 param

Creates one or more new databases within an existing space.

Name Type Required Description
databases array required No description.
fiberymcp_create_entities # Creates one or more entities in a Fibery database. 2 params

Creates one or more entities in a Fibery database.

Name Type Required Description
database string required Full database name (e.g., 'SoftDev/Task')
entities array required No description.
fiberymcp_create_files_fields # Creates file attachment fields in one or more databases. 1 param

Creates file attachment fields in one or more databases.

Name Type Required Description
fields array required No description.
fiberymcp_create_formula_field # Creates a formula field in a database; the formula expression is generated from a plain-language description. 3 params

Creates a formula field in a database; the formula expression is generated from a plain-language description.

Name Type Required Description
database string required Full database name (e.g., 'SoftDev/Task')
description string required Description of what the formula should calculate. The formula expression will be generated from this
name string required Name of the formula field in {Space}/{Field} format (e.g., 'SoftDev/Days Since Created'). Space prefix must match the database space
fiberymcp_create_icon_fields # Enables emoji icon fields on entities in one or more databases. 1 param

Enables emoji icon fields on entities in one or more databases.

Name Type Required Description
databases array required Array of full database names (e.g., ["SoftDev/Task"])
fiberymcp_create_multi_select_fields # Creates multi-select fields with predefined options in one or more databases. 1 param

Creates multi-select fields with predefined options in one or more databases.

Name Type Required Description
fields array required No description.
fiberymcp_create_primitive_fields # Creates primitive fields (text, number, date, boolean, etc.) in one or more databases. 1 param

Creates primitive fields (text, number, date, boolean, etc.) in one or more databases.

Name Type Required Description
fields array required No description.
fiberymcp_create_relation_fields # Creates relation fields between databases, establishing links in both the source and target database. 1 param

Creates relation fields between databases, establishing links in both the source and target database.

Name Type Required Description
fields array required No description.
fiberymcp_create_single_select_fields # Creates single-select fields with predefined options in one or more databases. 1 param

Creates single-select fields with predefined options in one or more databases.

Name Type Required Description
fields array required No description.
fiberymcp_create_space # Creates a new space in the Fibery workspace. 3 params

Creates a new space in the Fibery workspace.

Name Type Required Description
name string required Space name (e.g., "SoftDev")
color string optional Color for the space (hex color code, e.g., '#FF5722')
description string optional Description for the space
fiberymcp_create_view # Creates a saved view (grid, board, timeline, calendar, etc.) or standalone document in the Fibery workspace. 6 params

Creates a saved view (grid, board, timeline, calendar, etc.) or standalone document in the Fibery workspace.

Name Type Required Description
name string required Name of the view
viewType string required grid: spreadsheet table (supports hierarchical groupBy). list: simple list (prefer grid). board: kanban grouped by relation/enum on x and optionally y. timeline: time bars with optional milestones and dependencies. calendar: date events. map: geographic plot of a location field. feed: rich-text feed of a document field. gallery: card gallery with cover images. gantt: hierarchical timeline with dependencies. form: data input form. document: standalone markdown (use the `content` param). report: not yet supported here.
config object optional View configuration object. Shape depends on viewType — for anything beyond a basic grid/list with no filters or ordering, call get_tool_reference({toolName: 'create_view'}) first.
content string optional Markdown content (for document views)
description string optional Short description of the view in MD format
space string optional Space name to create the view in. Pass "Private" to save in Private space. By default, inferred from databases.
fiberymcp_create_workflow_field # Creates a workflow (state) field for tracking entity status through defined stages. 3 params

Creates a workflow (state) field for tracking entity status through defined stages.

Name Type Required Description
database string required Full database name (e.g., 'SoftDev/Task')
defaultOption string required Default state name for new entities
options array required Array of workflow state options
fiberymcp_delete_avatars_fields # Removes avatar fields from one or more databases; restorable via the Activity Log. 1 param

Removes avatar fields from one or more databases; restorable via the Activity Log.

Name Type Required Description
databases array required Array of full database names (e.g., ["SoftDev/Task"])
fiberymcp_delete_comments_fields # Removes comment fields from one or more databases; restorable via the Activity Log. 1 param

Removes comment fields from one or more databases; restorable via the Activity Log.

Name Type Required Description
databases array required Array of full database names (e.g., ["SoftDev/Task"])
fiberymcp_delete_databases # Deletes one or more databases from a space; restorable via the Activity Log. 1 param

Deletes one or more databases from a space; restorable via the Activity Log.

Name Type Required Description
databases array required Array of full database names to delete (e.g., ["SoftDev/Tasks"])
fiberymcp_delete_entities # Permanently deletes entities from a database by their IDs. 2 params

Permanently deletes entities from a database by their IDs.

Name Type Required Description
database string required Full database name (e.g., 'SoftDev/Task')
ids array required Array of entity IDs (fibery/id) to delete
fiberymcp_delete_fields # Deletes one or more fields from their databases; restorable via the Activity Log. 1 param

Deletes one or more fields from their databases; restorable via the Activity Log.

Name Type Required Description
fields array required No description.
fiberymcp_delete_icon_fields # Removes icon fields from one or more databases; restorable via the Activity Log. 1 param

Removes icon fields from one or more databases; restorable via the Activity Log.

Name Type Required Description
databases array required Array of full database names (e.g., ["SoftDev/Task"])
fiberymcp_delete_space # Deletes a space and all its databases from the workspace; restorable via the Activity Log. 1 param

Deletes a space and all its databases from the workspace; restorable via the Activity Log.

Name Type Required Description
name string required Space name to delete (e.g., "SoftDev")
fiberymcp_delete_views # Deletes one or more Fibery views by ID; the underlying data is not removed. 1 param

Deletes one or more Fibery views by ID; the underlying data is not removed.

Name Type Required Description
ids array required An array of fibery/id strings (of views) to be deleted
fiberymcp_delete_workflow_field # Deletes the workflow (state) field from a database; restorable via the Activity Log. 1 param

Deletes the workflow (state) field from a database; restorable via the Activity Log.

Name Type Required Description
database string required Full database name (e.g., 'SoftDev/Task')
fiberymcp_download_file # Fetches a Fibery file attachment by secret and returns a signed download URL valid for ~60 minutes. 1 param

Fetches a Fibery file attachment by secret and returns a signed download URL valid for ~60 minutes.

Name Type Required Description
secret string required File secret obtained from get_files_meta — opaque identifier returned in each file entry.
fiberymcp_fetch_by_url # Fetches entity or view data from a Fibery URL and returns it as Markdown. 2 params

Fetches entity or view data from a Fibery URL and returns it as Markdown.

Name Type Required Description
url string required Fibery URL to fetch data from
limit number optional Maximum number of items to return for views (default: 20)
fiberymcp_fetch_view_data # Fetches entity data from a Fibery view by executing its saved query. 3 params

Fetches entity data from a Fibery view by executing its saved query.

Name Type Required Description
publicId string required Public ID of the view to fetch data from
limit number optional Max entities to return (default: 100)
offset number optional Number of entities to skip (default: 0)
fiberymcp_get_connectors_list # Returns a list of available built-in connectors (integrations) in Fibery. 0 params

Returns a list of available built-in connectors (integrations) in Fibery.

fiberymcp_get_documents_content # Returns the Markdown content of one or more Fibery document fields identified by their secrets. 2 params

Returns the Markdown content of one or more Fibery document fields identified by their secrets.

Name Type Required Description
secrets array required Secrets of documents
reducePrompt string optional Controls how large documents are summarized when too long. By default: 'Summarize this document in 2-3 paragraphs max.'
fiberymcp_get_files_meta # Lists file attachments on one or more Fibery entities and returns their metadata. 3 params

Lists file attachments on one or more Fibery entities and returns their metadata.

Name Type Required Description
database string required Full database name in 'Space/Type' format, e.g. 'SoftDev/Task'. Use `schema` to discover available databases.
entityIds array required One or more fibery/id UUIDs of the entities whose file attachments to list.
field string optional Name of a specific file field to query. Omit to scan all file fields on the database. Use `schema_detailed` to discover available file fields.
fiberymcp_get_me # Returns information about the currently authenticated Fibery user. 0 params

Returns information about the currently authenticated Fibery user.

fiberymcp_get_tool_reference # Returns extended reference documentation for a specific Fibery MCP tool. 1 param

Returns extended reference documentation for a specific Fibery MCP tool.

Name Type Required Description
toolName string required The snake_case MCP tool name to look up (e.g. 'query', 'create_entities')
fiberymcp_query # Runs a structured Fibery query to select, filter, order, paginate, and aggregate data. 2 params

Runs a structured Fibery query to select, filter, order, paginate, and aggregate data.

Name Type Required Description
query object required No description.
params object optional Not used anymore, left for backwards compatibility
fiberymcp_query_views # Queries saved views in the Fibery workspace, optionally filtering by ID, public ID, name, or type. 5 params

Queries saved views in the Fibery workspace, optionally filtering by ID, public ID, name, or type.

Name Type Required Description
id string optional Filter by fibery/id of the view
publicId string optional Filter by public ID of the view
text string optional Text search in view name or description
viewType string optional Filter by view type
withConfig boolean optional Specify whether to include view config (like, what database are present on this view, what fields are shown). true by default. Set to false if not filtering by id filters since there can be many views returned
fiberymcp_remove_collection_items # Removes related entities from a Collection field on a Fibery entity. 4 params

Removes related entities from a Collection field on a Fibery entity.

Name Type Required Description
database string required Full database name (e.g., 'SoftDev/Task')
entityId string required fibery/id of an entity
field string required The name of the collection field
items array required An array of related entity ids to remove from the collection. Each entry must be fibery/id of the entity to add
fiberymcp_rename_databases # Renames one or more databases, optionally moving them to a different space. 1 param

Renames one or more databases, optionally moving them to a different space.

Name Type Required Description
databases array required No description.
fiberymcp_rename_fields # Renames one or more fields within their databases. 1 param

Renames one or more fields within their databases.

Name Type Required Description
fields array required No description.
fiberymcp_schema # Returns the high-level workspace structure showing all spaces and databases. 0 params

Returns the high-level workspace structure showing all spaces and databases.

fiberymcp_schema_detailed # Returns detailed schema for specified databases, including fields and related databases. 2 params

Returns detailed schema for specified databases, including fields and related databases.

Name Type Required Description
databases array required An array of database names (in "Space/Database" format).
includeRelatedDatabases boolean optional Whether to include related databases with their descriptions & fields. Defaults to false. Set to true if the schema is small and you want to navigate faster.
fiberymcp_search_guide # Fetches relevant information from the Fibery User Guide based on a query. 1 param

Fetches relevant information from the Fibery User Guide based on a query.

Name Type Required Description
query string required The query for searching
fiberymcp_search_history # Searches the workspace activity history and returns matching history events. 13 params

Searches the workspace activity history and returns matching history events.

Name Type Required Description
actions array optional Filter by action types
authorUserId string optional Filter by author's fibery/id
database string optional Filter by database name (e.g., 'Projects/Task')
entityId string optional Filter by entity fibery/id
entityName string optional Filter by entity name (substring match)
entityPublicId string optional Filter by entity public ID (requires database to be set)
entityState array optional Filter by entity states
excludeAutomaticChanges string optional Exclude automatic changes (all excluded by default)
limit number optional Maximum number of items to return (default: 50, max: 100)
schemaChange array optional Filter by schema change types
since string optional Start of time range (ISO 8601). Defaults to 24 hours ago
sinceItem string optional Cursor for pagination — last item ID from previous result
until string optional End of time range (ISO 8601). Defaults to now. Difference between dates in until and since cannot be more than 12 months
fiberymcp_set_document_content # Sets (replaces) the content of a document field on a Fibery entity. 4 params

Sets (replaces) the content of a document field on a Fibery entity.

Name Type Required Description
content string required Document's content in MD format. It has to be full document content
database string required Full database name (e.g., 'SoftDev/Task')
entityId string required fibery/id of an entity
field string required The name of the document field
fiberymcp_set_state # Sets the workflow state of a Fibery entity. 3 params

Sets the workflow state of a Fibery entity.

Name Type Required Description
database string required Full database name (e.g., 'SoftDev/Task')
entityId string required fibery/id of an entity
state string required State title (enum/name)
fiberymcp_update_entities # Updates fields on one or more existing Fibery entities. 2 params

Updates fields on one or more existing Fibery entities.

Name Type Required Description
database string required Full database name (e.g., 'SoftDev/Task')
entities array required No description.
fiberymcp_update_formula_field # Updates an existing formula field by regenerating its expression from a new description. 3 params

Updates an existing formula field by regenerating its expression from a new description.

Name Type Required Description
database string required Full database name (e.g., 'SoftDev/Task')
description string required New description of what the formula should calculate. A new formula expression will be generated from this
name string required Name of the existing formula field in {Space}/{Field} format (e.g., 'SoftDev/Days Since Created')
fiberymcp_update_multi_select_fields # Updates the options of one or more existing multi-select fields. 1 param

Updates the options of one or more existing multi-select fields.

Name Type Required Description
fields array required No description.
fiberymcp_update_single_select_fields # Updates the options of one or more existing single-select fields. 1 param

Updates the options of one or more existing single-select fields.

Name Type Required Description
fields array required No description.
fiberymcp_update_view # Updates an existing Fibery view's name, description, space, content, or configuration. 8 params

Updates an existing Fibery view's name, description, space, content, or configuration.

Name Type Required Description
id string required fibery/id of the view to update
viewType string required grid: spreadsheet table (supports hierarchical groupBy). list: simple list (prefer grid). board: kanban grouped by relation/enum on x and optionally y. timeline: time bars with optional milestones and dependencies. calendar: date events. map: geographic plot of a location field. feed: rich-text feed of a document field. gallery: card gallery with cover images. gantt: hierarchical timeline with dependencies. form: data input form. document: standalone markdown (use the `content` param). report: not yet supported here.
append boolean optional If true, append content instead of replacing (document views only)
config object optional View configuration object. Shape depends on viewType — for anything beyond a basic grid/list with no filters or ordering, call get_tool_reference({toolName: 'create_view'}) first.
content string optional Markdown content (for document views)
description string optional New description for the view
name string optional New name for the view
space string optional Move the view to a different space
fiberymcp_update_workflow_field # Updates the options of an existing workflow (state) field. 3 params

Updates the options of an existing workflow (state) field.

Name Type Required Description
database string required Full database name
update string required Full replacement or incremental update
defaultOption string optional New default state name. If not provided, the default is left unchanged