Line Bot MCP Server

What line/line-bot-mcp-server MCP server does

The line/line-bot-mcp-server MCP server exposes LINE Messaging API operations as MCP tools for an AI agent. It supports direct text delivery and customizable Flex messages, both to an individual user and to all users who have followed a LINE Official Account. Individual message tools accept a user ID, while a configured default recipient can be used when the tool input omits one.

The server also reads account and user information. Agents can retrieve a user's display name, profile image URL, status message, and language; inspect the account's monthly message quota and current consumption; and page through follower IDs using a continuation token and optional result limit.

Rich-menu administration is included. Available operations cover listing menus, deleting a menu, assigning or removing the default menu, and creating a menu with one to six actions. Creation can generate and upload the menu image, set the new menu as default, and use actions such as postback, message, URI, date/time picker, camera, camera roll, location, rich-menu switching, and clipboard copy.

How it works

The MCP process authenticates against LINE with a channel access token. Its tools then make operations available to a connected agent such as Claude Desktop or Cline. Push and broadcast tools accept plain text or Flex message JSON; Flex containers can be a single bubble or a carousel of bubbles.

For direct messages, userId is optional only when DESTINATION_USER_ID has been configured. The follower-list operation returns user IDs in pages and provides a continuation value for retrieving the next page. Rich-menu tools use the menu ID returned by LINE or supplied by an earlier operation.

Setup and configuration

A LINE Official Account with the Messaging API enabled is required. The required environment variable is CHANNEL_ACCESS_TOKEN. Set DESTINATION_USER_ID to provide a default recipient; otherwise, every direct push request must include userId.

The documented npx setup uses the @line/line-bot-mcp-server package and requires Node.js 22 or later. The repository also documents a Docker workflow that builds the line/line-bot-mcp-server image after cloning the project. In the supplied agent example, NPM_CONFIG_IGNORE_SCRIPTS is set to true for the npx configuration.

For local development, the project can be cloned, installed with npm, built with npm run build, and tested through MCP Inspector. The Inspector example starts the built dist/index.js entry point with the LINE credentials supplied as environment variables.

Tools and capabilities

The line/line-bot-mcp-server MCP server includes these operations:

• Push text or Flex messages to one user.
• Broadcast text or Flex messages to all followers.
• Retrieve a user's profile.
• Check message quota and usage.
• List, create, delete, set, or cancel a default rich menu.
• Retrieve follower IDs with pagination.

Limitations and notes

The repository describes the project as a preview for experimental use and notes that functionality and support may be incomplete. The server requires an existing LINE Official Account and Messaging API configuration; it does not create that account. Flex message contents must be provided as JSON conforming to LINE's expected structure, and rich-menu creation accepts only one to six actions.