Skip to main content
Glama
LINE Bot MCP Server

LINE Bot MCP Server

by pythoncdev

日本語版 READMEはこちら

LINE Bot MCP Server

npmjs

Model Context Protocol (MCP) server implementation that integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account.

NOTE

This repository is provided as a preview version. While we offer it for experimental purposes, please be aware that it may not include complete functionality or comprehensive support.

Tools

  1. push_text_message

    • Push a simple text message to a user via LINE.

    • Inputs:

      • userId (string?): The user ID to receive a message. Defaults to DESTINATION_USER_ID. Either userId or DESTINATION_USER_ID must be set.

      • message.text (string): The plain text content to send to the user.

  2. push_flex_message

    • Push a highly customizable flex message to a user via LINE.

    • Inputs:

      • userId (string?): The user ID to receive a message. Defaults to DESTINATION_USER_ID. Either userId or DESTINATION_USER_ID must be set.

      • message.altText (string): Alternative text shown when flex message cannot be displayed.

      • message.contents (any): The contents of the flex message. This is a JSON object that defines the layout and components of the message.

      • message.contents.type (enum): Type of the container. 'bubble' for single container, 'carousel' for multiple swipeable bubbles.

  3. broadcast_text_message

    • Broadcast a simple text message via LINE to all users who have followed your LINE Official Account.

    • Inputs:

      • message.text (string): The plain text content to send to the users.

  4. broadcast_flex_message

    • Broadcast a highly customizable flex message via LINE to all users who have added your LINE Official Account.

    • Inputs:

      • message.altText (string): Alternative text shown when flex message cannot be displayed.

      • message.contents (any): The contents of the flex message. This is a JSON object that defines the layout and components of the message.

      • message.contents.type (enum): Type of the container. 'bubble' for single container, 'carousel' for multiple swipeable bubbles.

  5. get_profile

    • Get detailed profile information of a LINE user including display name, profile picture URL, status message and language.

    • Inputs:

      • userId (string?): The ID of the user whose profile you want to retrieve. Defaults to DESTINATION_USER_ID.

  6. get_message_quota

    • Get the message quota and consumption of the LINE Official Account. This shows the monthly message limit and current usage.

    • Inputs:

      • None

  7. get_rich_menu_list

    • Get the list of rich menus associated with your LINE Official Account.

    • Inputs:

      • None

  8. delete_rich_menu

    • Delete a rich menu from your LINE Official Account.

    • Inputs:

      • richMenuId (string): The ID of the rich menu to delete.

  9. set_rich_menu_default

    • Set a rich menu as the default rich menu.

    • Inputs:

      • richMenuId (string): The ID of the rich menu to set as default.

  10. cancel_rich_menu_default

    • Cancel the default rich menu.

    • Inputs:

      • None

  11. create_rich_menu

    • Create a rich menu based on the given actions. Generate and upload an image. Set as default.

    • Inputs:

      • chatBarText (string): Text displayed in chat bar, also used as rich menu name.

      • actions (array): The actions of the rich menu. You can specify minimum 1 to maximum 6 actions. Each action can be one of the following types:

        • postback: For sending a postback action

        • message: For sending a text message

        • uri: For opening a URL

        • datetimepicker: For opening a date/time picker

        • camera: For opening the camera

        • cameraRoll: For opening the camera roll

        • location: For sending the current location

        • richmenuswitch: For switching to another rich menu

        • clipboard: For copying text to clipboard

  12. get_follower_ids

    • Get a list of user IDs of users who have added the LINE Official Account as a friend. This allows you to obtain user IDs for sending messages without manually preparing them.

    • Inputs:

      • start (string?): Continuation token to get the next array of user IDs. Returned in the next property of a previous response.

      • limit (number?): The maximum number of user IDs to retrieve in a single request.

  13. get_group_summary

    • Get the group chat summary including group ID, group name, and group icon URL, using the group ID.

    • Inputs:

      • groupId (string): The group ID of the target group chat.

Related MCP server: line-bot-mcp-server

Installation (Using npx)

requirements:

  • Node.js v22 or later

Step 1: Create LINE Official Account

This MCP server utilizes a LINE Official Account. If you do not have one, please create it by following this instructions.

If you have a LINE Official Account, enable the Messaging API for your LINE Official Account by following this instructions.

Step 2: Configure AI Agent

Please add the following configuration for an AI Agent like Claude Desktop or Cline.

Set the environment variables or arguments as follows:

  • CHANNEL_ACCESS_TOKEN: (required) Channel Access Token. You can confirm this by following this instructions.

  • DESTINATION_USER_ID: (optional) The default user ID of the recipient. If the Tool's input does not include userId, DESTINATION_USER_ID is required. You can confirm this by following this instructions.

{
  "mcpServers": {
    "line-bot": {
      "command": "npx",
      "args": [
        "@line/line-bot-mcp-server"
      ],
      "env": {
        "NPM_CONFIG_IGNORE_SCRIPTS": "true",
        "CHANNEL_ACCESS_TOKEN" : "FILL_HERE",
        "DESTINATION_USER_ID" : "FILL_HERE"
      }
    }
  }
}

Installation (Using Docker)

Step 1: Create LINE Official Account

This MCP server utilizes a LINE Official Account. If you do not have one, please create it by following this instructions.

If you have a LINE Official Account, enable the Messaging API for your LINE Official Account by following this instructions.

Step 2: Build line-bot-mcp-server image

Clone this repository:

git clone git@github.com:line/line-bot-mcp-server.git

Build the Docker image:

docker build -t line/line-bot-mcp-server .

Step 3: Configure AI Agent

Please add the following configuration for an AI Agent like Claude Desktop or Cline.

Set the environment variables or arguments as follows:

  • mcpServers.args: (required) The path to line-bot-mcp-server.

  • CHANNEL_ACCESS_TOKEN: (required) Channel Access Token. You can confirm this by following this instructions.

  • DESTINATION_USER_ID: (optional) The default user ID of the recipient. If the Tool's input does not include userId, DESTINATION_USER_ID is required. You can confirm this by following this instructions.

{
  "mcpServers": {
    "line-bot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CHANNEL_ACCESS_TOKEN",
        "-e",
        "DESTINATION_USER_ID",
        "line/line-bot-mcp-server"
      ],
      "env": {
        "CHANNEL_ACCESS_TOKEN" : "FILL_HERE",
        "DESTINATION_USER_ID" : "FILL_HERE"
      }
    }
  }
}

Local Development with Inspector

You can use the MCP Inspector to test and debug the server locally.

Prerequisites

  1. Clone the repository:

git clone git@github.com:line/line-bot-mcp-server.git
cd line-bot-mcp-server
  1. Install dependencies:

npm install
  1. Build the project:

npm run build

Run the Inspector

After building the project, you can start the MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js \
  -e CHANNEL_ACCESS_TOKEN="YOUR_CHANNEL_ACCESS_TOKEN" \
  -e DESTINATION_USER_ID="YOUR_DESTINATION_USER_ID"

This will start the MCP Inspector interface where you can interact with the LINE Bot MCP Server tools and test their functionality.

Versioning

This project respects semantic versioning

See http://semver.org/

Contributing

Please check CONTRIBUTING before making a contribution.

Available Tools

13 tools
broadcast_flex_messageBroadcast Flex MessageA
Destructive

Broadcast a highly customizable flex message via LINE to all users who have added your LINE Official Account. Supports both bubble (single container) and carousel (multiple swipeable bubbles) layouts. Please be aware that this message will be sent to all users.

Inputs: message (required).

broadcast_text_messageBroadcast Text MessageA
Destructive

Broadcast a simple text message via LINE to all users who have followed your LINE Official Account. Use this for sending plain text messages without formatting. Please be aware that this message will be sent to all users.

Inputs: message (required).

cancel_rich_menu_defaultCancel Rich Menu DefaultB
Destructive

Cancel the default rich menu.

Inputs: no named parameters.

create_rich_menuCreate Rich MenuB
Destructive

Create a rich menu based on the given actions. Generate and upload a rich menu image based on the given action. This rich menu will be registered as the default.

Inputs: actions (required), chatBarText (required).

delete_rich_menuDelete Rich MenuB
Destructive

Delete a rich menu from your LINE Official Account.

Inputs: richMenuId (required).

get_follower_idsA
Read-only

Get a list of user IDs of users who have added the LINE Official Account as a friend. This allows you to obtain user IDs for sending messages without manually preparing them.

Inputs: limit, start.

get_group_summaryGet Group SummaryB
Read-only

Get the group chat summary including group ID, group name, and group icon URL, using the group ID.

Inputs: groupId (required).

get_message_quotaGet Message QuotaA
Read-only

Get the message quota and consumption of the LINE Official Account. This shows the monthly message limit and current usage.

Inputs: no named parameters.

get_profileGet ProfileA
Read-only

Get detailed profile information of a LINE user including display name, profile picture URL, status message and language.

Inputs: userId.

get_rich_menu_listGet Rich Menu ListA
Read-only

Get the list of rich menus associated with your LINE Official Account.

Inputs: no named parameters.

push_flex_messagePush Flex MessageB
Destructive

Push a highly customizable flex message to a user via LINE. Supports both bubble (single container) and carousel (multiple swipeable bubbles) layouts.

Inputs: message (required), userId.

push_text_messagePush Text MessageA
Destructive

Push a simple text message to a user via LINE. Use this for sending plain text messages without formatting.

Inputs: message (required), userId.

set_rich_menu_defaultSet Rich Menu DefaultB
Destructive

Set a rich menu as the default rich menu.

Inputs: richMenuId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 13 tools

    Disambiguation4/5

    Push vs broadcast tools are clearly differentiated by description (single user vs all followers), and text vs flex variants are distinct. The 2x2 grid of push/broadcast × text/flex and the cluster of rich-menu operations are well-bounded, though an agent must read carefully to pick correctly.

    Naming Consistency5/5

    Every tool follows a consistent snake_case verb-first pattern (get_, create_, delete_, set_, cancel_, push_, broadcast_). The convention is predictable throughout with no mixed styles.

    Tool Count5/5

    13 tools is well within the ideal range and each tool earns its place, covering messaging, rich-menu management, and account/user lookups without redundancy.

    Completeness4/5

    Core lifecycle is covered: messaging (push/broadcast), rich-menu CRUD plus default set/cancel, profile, quota, followers, and group summary. Gaps remain (no per-user rich-menu linking, no multicast/narrowcast, no get-single-rich-menu), but agents can work around these.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables AI agents to send messages, manage rich menus, and interact with users through LINE Official Accounts via the LINE Messaging API. Supports both individual messaging and broadcasting to all followers with text and customizable flex messages.
      18
      Apache 2.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to control a LINE Official Account via the Messaging API, including sending text and flex messages, broadcasting, retrieving user profiles and follower IDs, and managing rich menus.
      12
      2,612 npm
      Apache 2.0
    • A
      license
      A
      quality
      Not graded
      maintenance
      Enables an AI agent to connect to a LINE Official Account via the LINE Messaging API, sending push and broadcast text or flex messages, managing rich menus, and retrieving user profiles, message quotas, follower IDs, and group summaries.
      13
      Apache 2.0
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI agents to operate one or many LINE Official Accounts through natural conversation, covering broadcasts, Flex and tappable Rich Messages, rich menus, coupons, audiences, insights, LIFF, webhooks, and LINE Shopping. Includes pre-flight quota and quiet-hour guardrails, zero-setup image hosting for Rich Messages, Thai-localized responses, and both stdio and bearer-authenticated HTTP transports.
      200 npm
      MIT