Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Fibery MCP connector

OAuth 2.1/DCRProject 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.

NameTypeRequiredDescription
databasestringrequiredFull database name (e.g., 'SoftDev/Task')
entityIdstringrequiredfibery/id of an entity
fieldstringrequiredThe name of the collection field
itemsarrayrequiredAn 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.

NameTypeRequiredDescription
contentstringrequiredComment content in Markdown format
databasestringrequiredFull database name (e.g., 'SoftDev/Task'). Must be a database that supports comments (has the comments/comments collection).
entityIdstringrequiredfibery/id of the entity to comment on
parentCommentIdstringoptionalfibery/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.

NameTypeRequiredDescription
databasestringrequiredFull database name (e.g., 'SoftDev/Task')
entityIdstringrequiredfibery/id of an entity
fieldstringrequiredExact 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.
fileNamestringrequiredName of the file to be added (e.g., 'Report.pdf')
urlstringrequiredHTTP(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.

NameTypeRequiredDescription
contentstringrequiredDocument's content in MD format. Any content you write here will be APPENDED to already existing content in the document
databasestringrequiredFull database name (e.g., 'SoftDev/Task')
entityIdstringrequiredfibery/id of an entity
fieldstringrequiredThe 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.

NameTypeRequiredDescription
databasesarrayrequiredArray 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.

NameTypeRequiredDescription
databasesarrayrequiredArray 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.

NameTypeRequiredDescription
databasesarrayrequiredNo description.
fiberymcp_create_entities#Creates one or more entities in a Fibery database.2 params

Creates one or more entities in a Fibery database.

NameTypeRequiredDescription
databasestringrequiredFull database name (e.g., 'SoftDev/Task')
entitiesarrayrequiredNo 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.

NameTypeRequiredDescription
fieldsarrayrequiredNo 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.

NameTypeRequiredDescription
databasestringrequiredFull database name (e.g., 'SoftDev/Task')
descriptionstringrequiredDescription of what the formula should calculate. The formula expression will be generated from this
namestringrequiredName 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.

NameTypeRequiredDescription
databasesarrayrequiredArray 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.

NameTypeRequiredDescription
fieldsarrayrequiredNo 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.

NameTypeRequiredDescription
fieldsarrayrequiredNo 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.

NameTypeRequiredDescription
fieldsarrayrequiredNo 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.

NameTypeRequiredDescription
fieldsarrayrequiredNo description.
fiberymcp_create_space#Creates a new space in the Fibery workspace.3 params

Creates a new space in the Fibery workspace.

NameTypeRequiredDescription
namestringrequiredSpace name (e.g., "SoftDev")
colorstringoptionalColor for the space (hex color code, e.g., '#FF5722')
descriptionstringoptionalDescription 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.

NameTypeRequiredDescription
namestringrequiredName of the view
viewTypestringrequiredgrid: 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.
configobjectoptionalView 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.
contentstringoptionalMarkdown content (for document views)
descriptionstringoptionalShort description of the view in MD format
spacestringoptionalSpace 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.

NameTypeRequiredDescription
databasestringrequiredFull database name (e.g., 'SoftDev/Task')
defaultOptionstringrequiredDefault state name for new entities
optionsarrayrequiredArray 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.

NameTypeRequiredDescription
databasesarrayrequiredArray 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.

NameTypeRequiredDescription
databasesarrayrequiredArray 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.

NameTypeRequiredDescription
databasesarrayrequiredArray 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.

NameTypeRequiredDescription
databasestringrequiredFull database name (e.g., 'SoftDev/Task')
idsarrayrequiredArray 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.

NameTypeRequiredDescription
fieldsarrayrequiredNo 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.

NameTypeRequiredDescription
databasesarrayrequiredArray 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.

NameTypeRequiredDescription
namestringrequiredSpace 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.

NameTypeRequiredDescription
idsarrayrequiredAn 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.

NameTypeRequiredDescription
databasestringrequiredFull 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.

NameTypeRequiredDescription
secretstringrequiredFile 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.

NameTypeRequiredDescription
urlstringrequiredFibery URL to fetch data from
limitnumberoptionalMaximum 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.

NameTypeRequiredDescription
publicIdstringrequiredPublic ID of the view to fetch data from
limitnumberoptionalMax entities to return (default: 100)
offsetnumberoptionalNumber 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.

NameTypeRequiredDescription
secretsarrayrequiredSecrets of documents
reducePromptstringoptionalControls 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.

NameTypeRequiredDescription
databasestringrequiredFull database name in 'Space/Type' format, e.g. 'SoftDev/Task'. Use `schema` to discover available databases.
entityIdsarrayrequiredOne or more fibery/id UUIDs of the entities whose file attachments to list.
fieldstringoptionalName 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.

NameTypeRequiredDescription
toolNamestringrequiredThe 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.

NameTypeRequiredDescription
queryobjectrequiredNo description.
paramsobjectoptionalNot 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.

NameTypeRequiredDescription
idstringoptionalFilter by fibery/id of the view
publicIdstringoptionalFilter by public ID of the view
textstringoptionalText search in view name or description
viewTypestringoptionalFilter by view type
withConfigbooleanoptionalSpecify 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.

NameTypeRequiredDescription
databasestringrequiredFull database name (e.g., 'SoftDev/Task')
entityIdstringrequiredfibery/id of an entity
fieldstringrequiredThe name of the collection field
itemsarrayrequiredAn 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.

NameTypeRequiredDescription
databasesarrayrequiredNo description.
fiberymcp_rename_fields#Renames one or more fields within their databases.1 param

Renames one or more fields within their databases.

NameTypeRequiredDescription
fieldsarrayrequiredNo 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.

NameTypeRequiredDescription
databasesarrayrequiredAn array of database names (in "Space/Database" format).
includeRelatedDatabasesbooleanoptionalWhether 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.

NameTypeRequiredDescription
querystringrequiredThe 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.

NameTypeRequiredDescription
actionsarrayoptionalFilter by action types
authorUserIdstringoptionalFilter by author's fibery/id
databasestringoptionalFilter by database name (e.g., 'Projects/Task')
entityIdstringoptionalFilter by entity fibery/id
entityNamestringoptionalFilter by entity name (substring match)
entityPublicIdstringoptionalFilter by entity public ID (requires database to be set)
entityStatearrayoptionalFilter by entity states
excludeAutomaticChangesstringoptionalExclude automatic changes (all excluded by default)
limitnumberoptionalMaximum number of items to return (default: 50, max: 100)
schemaChangearrayoptionalFilter by schema change types
sincestringoptionalStart of time range (ISO 8601). Defaults to 24 hours ago
sinceItemstringoptionalCursor for pagination — last item ID from previous result
untilstringoptionalEnd 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.

NameTypeRequiredDescription
contentstringrequiredDocument's content in MD format. It has to be full document content
databasestringrequiredFull database name (e.g., 'SoftDev/Task')
entityIdstringrequiredfibery/id of an entity
fieldstringrequiredThe 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.

NameTypeRequiredDescription
databasestringrequiredFull database name (e.g., 'SoftDev/Task')
entityIdstringrequiredfibery/id of an entity
statestringrequiredState 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.

NameTypeRequiredDescription
databasestringrequiredFull database name (e.g., 'SoftDev/Task')
entitiesarrayrequiredNo 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.

NameTypeRequiredDescription
databasestringrequiredFull database name (e.g., 'SoftDev/Task')
descriptionstringrequiredNew description of what the formula should calculate. A new formula expression will be generated from this
namestringrequiredName 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.

NameTypeRequiredDescription
fieldsarrayrequiredNo 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.

NameTypeRequiredDescription
fieldsarrayrequiredNo 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.

NameTypeRequiredDescription
idstringrequiredfibery/id of the view to update
viewTypestringrequiredgrid: 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.
appendbooleanoptionalIf true, append content instead of replacing (document views only)
configobjectoptionalView 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.
contentstringoptionalMarkdown content (for document views)
descriptionstringoptionalNew description for the view
namestringoptionalNew name for the view
spacestringoptionalMove 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.

NameTypeRequiredDescription
databasestringrequiredFull database name
updatestringrequiredFull replacement or incremental update
defaultOptionstringoptionalNew default state name. If not provided, the default is left unchanged