Kickflow

You can access the Kickflow Model Context Protocol (MCP) server to interact with Kickflow APIs through MCP-enabled clients. This server bridges your MCP client with Kickflow services, enabling programmatic actions like auditing, category management, ticket handling, organizational structures, roles, and more via structured MCP endpoints.

How to use

You use the MCP server from your MCP-enabled client by configuring an MCP server entry that points to the Kickflow MCP server. The server runs locally or via a standard runtime, and you provide an access token to authorize requests. Once configured, you can perform actions such as listing resources, creating items, updating records, and managing workflows through the MCP endpoints exposed by this server.

How to install

Prerequisites you need before installation are Node.js version 22.18.0 or newer and a Kickflow access token.

Add the MCP server configuration to your MCP client configuration file (for example, claude_desktop_config.json or similar). You will set the access token in the environment for the MCP server.

MacOS/Linux setup snippet you can adapt into your client configuration is shown below.

{
  "mcpServers": {
    "kickflow": {
      "command": "npx",
      "args": ["-y", "@kickflow/mcp-server"],
      "env": {
        "KICKFLOW_ACCESS_TOKEN": "your-kickflow-access-token"
      }
    }
  }
}

Windows setup snippet you can adapt into your client configuration is shown below.

{
  "mcpServers": {
    "kickflow": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@kickflow/mcp-server"],
      "env": {
        "KICKFLOW_ACCESS_TOKEN": "your-kickflow-access-token"
      }
    }
  }
}

Configuration details and environment variables

The MCP server requires an access token to be provided to authorize requests. Set the token value in the environment variable KICKFLOW_ACCESS_TOKEN for your MCP client configuration.

Notes on security and usage

Keep your access token secret and rotate it periodically. Do not share configuration snippets or tokens in public or insecure channels. Use the token only in trusted MCP client environments.

Available tools

list_audit_logs

Retrieve a list of audit logs to review actions and changes within the system.

list_categories

Fetch all categories; supports listing and organizing categories used across items.

create_category

Create a new category to classify items such as tickets or records.

delete_category

Remove a category from the system.

update_category

Modify an existing category's properties.

list_comments

Get all comments attached to a ticket or item.

create_comment

Add a new comment to a ticket.

get_comment

Retrieve a specific comment by its identifier.

update_comment

Edit the content of an existing comment.

delete_comment

Delete a comment from a ticket.

list_folders

List all folders used for organizing items.

create_folder

Create a new folder.

delete_folder

Remove a folder.

update_folder

Update folder properties.

get_folder

Fetch a single folder by its identifier.

list_general_master_items

List generic master items used across the system.

create_general_master_item

Create a new general master item.

get_general_master_item

Get a specific general master item.

update_general_master_item

Update a general master item.

delete_general_master_item

Delete a general master item.

list_general_masters

List general masters.

create_general_master

Create a new general master.

get_general_master

Retrieve a specific general master.

update_general_master

Update a general master.

delete_general_master

Delete a general master.

list_grades

List positions or grades within the organization.

create_grade

Create a new grade.

get_grade

Get a specific grade.

delete_grade

Remove a grade.

update_grade

Update a grade's details.

set_default_grade

Set a specific grade as the default.

list_organization_charts

List organization charts.

create_organization_chart

Create a new organization chart.

delete_organization_chart

Delete an organization chart.

get_organization_chart

Retrieve a single organization chart.

update_organization_chart

Update an organization chart.

get_current_organization_chart

Get the currently active organization chart.

activate_organization_chart

Activate a chosen organization chart.

list_proxy_applicants

List proxy applicants.

create_proxy_applicant

Create a proxy applicant.

delete_proxy_applicant

Delete a proxy applicant.

list_proxy_approvers

List proxy approvers.

create_proxy_approver

Create a proxy approver.

delete_proxy_approver

Delete a proxy approver.

list_roles

List administrator roles.

create_role

Create a new administrator role.

get_role

Retrieve a specific administrator role.

update_role

Update an administrator role.

delete_role

Delete an administrator role.

create_role_members

Add members to an administrator role.

list_role_members

List members of an administrator role.

delete_role_member

Remove a member from an administrator role.

list_routes

List available routes.

get_route

Get details of a specific route.

list_teams

List teams within a chosen organization chart.

create_team

Create a team within an organization chart.

get_team

Retrieve a specific team.

update_team

Update team details.

delete_team

Delete a team.

list_team_members

List members of a team.

create_team_members

Add members to a team.

delete_team_members

Remove members from a team.

update_team_member

Update team member information.

list_ticket_links

List tickets related to a specific ticket.

get_ticket

Get detailed information about a ticket.

list_tickets

List tickets.

approve_ticket

Approve or approve-and-check a ticket.

reject_ticket

Reject or send back a ticket.

deny_ticket

Deny a ticket.

withdraw_ticket

Withdraw a ticket created by you.

archive_ticket

Archive a ticket.

list_tasks

List approval requests.

get_current_user

Get information about the current user.

list_users

List users.

create_user

Create or invite a new user.

get_user

Retrieve a specific user.

delete_user

Delete a user.

update_user

Update user details.

lookup_user_by_email

Find a user by email address.

reinvite_user

Reinvite a removed user.

suspend_user

Temporarily suspend a active user.

reactivate_user

Reactivate a suspended user.

list_user_teams

List teams the user belongs to.

list_user_roles

List administrator roles for the user.

list_viewers

List users who can view a ticket.

create_viewer

Add a viewer to a ticket.

delete_viewer

Remove a viewer from a ticket.

list_workflows

List available workflows.

get_workflow

Get details of a specific workflow.