Skip to main content
Glama
@zients/line-mcp-server

@zients/line-mcp-server

by zients

@zients/line-mcp-server

npm version CI Node.js License: MIT

MCP Server for LINE Messaging API — let AI agents send messages, manage groups, configure rich menus, and query analytics on LINE. Works with Codex CLI, Claude Code, OpenClaw, and any MCP-compatible client.

Disclaimer: This project is not affiliated with, endorsed by, or sponsored by LY Corporation or LINE.

Features

Messaging (12 tools)

Tool

Description

push_text_message

Send text to a user, group, or room

push_image_message

Send an image (HTTPS URLs only)

push_sticker_message

Send a LINE sticker

push_flex_message

Send a Flex Message (rich layout)

push_video_message

Send a video (HTTPS URLs only)

push_audio_message

Send an audio clip (HTTPS URLs only)

push_location_message

Send a location (lat/lng)

show_loading_indicator

Display a loading animation in a chat

broadcast_text_message

Broadcast text to all followers

multicast_text_message

Send text to multiple users (max 500)

broadcast_flex_message

Broadcast a Flex Message to all followers

multicast_flex_message

Send a Flex Message to multiple users (max 500)

Profile (2 tools)

Tool

Description

get_user_profile

Get user display name, picture, status, and language

get_group_summary

Get group name and picture (bot must be a member of the group)

Group & Room Management (8 tools)

Tool

Description

get_group_member_count

Get number of members in a group

get_group_member_ids

List all member IDs in a group

get_group_member_profile

Get a specific member's profile within a group

leave_group

Bot leaves a group (permanent)

get_room_member_count

Get number of members in a room

get_room_member_ids

List all member IDs in a room

get_room_member_profile

Get a specific member's profile within a room

leave_room

Bot leaves a room (permanent)

Rich Menu (9 tools)

Tool

Description

create_rich_menu

Create a new rich menu

list_rich_menus

List all rich menus

get_rich_menu

Get a specific rich menu by ID

delete_rich_menu

Delete a rich menu

set_default_rich_menu

Set the default rich menu for all users

get_default_rich_menu

Get the current default rich menu ID

cancel_default_rich_menu

Remove the default rich menu

link_rich_menu_to_user

Assign a rich menu to a specific user

unlink_rich_menu_from_user

Remove a user's assigned rich menu

Insight & Analytics (13 tools)

Tool

Description

get_bot_info

Get bot's display name, ID, chat mode, and mark-as-read mode

get_message_quota

Get monthly message sending quota

get_message_quota_consumption

Get messages sent this month

get_follower_ids

List follower user IDs (paginated)

get_number_of_followers

Get follower count statistics for a date (yyyyMMdd, UTC+9)

get_friend_demographics

Get follower demographic data (age, gender, area)

get_sent_reply_count

Get number of sent reply messages for a date (yyyyMMdd, UTC+9)

get_sent_push_count

Get number of sent push messages for a date (yyyyMMdd, UTC+9)

get_sent_multicast_count

Get number of sent multicast messages for a date (yyyyMMdd, UTC+9)

get_sent_broadcast_count

Get number of sent broadcast messages for a date (yyyyMMdd, UTC+9)

get_message_deliveries

Get number of message deliveries for a date (yyyyMMdd, UTC+9)

get_message_event

Get message event statistics by request ID

get_statistics_per_unit

Get statistics for a custom aggregation unit within a date range

Related MCP server: LINE Bot MCP Server

Prerequisites

  • Node.js >= 22

  • A LINE Official Account with Messaging API enabled

  • Channel Access Token

Create a LINE Official Account

  1. Go to LINE Official Account Manager and create an account

  2. Go to LINE Developers Console and log in

  3. Create a Provider (or select an existing one)

  4. Under the Provider, create a Messaging API Channel linked to your Official Account

  5. Go back to LINE Developers Console, select your Provider and Channel

  6. In the Basic settings tab, find Your user ID (U...) — for testing push messages to yourself

  7. Go to the Messaging API tab, scroll to the bottom, and click Issue under Channel access token (long-lived) to generate your token

Enable Group/Room Features (Optional)

To use group/room tools or send messages to groups and rooms:

  1. In LINE Official Account Manager → Settings → Account settings → enable Allow bot to join groups

  2. In LINE Official Account Manager → Settings → Response settings → enable Webhook

  3. In LINE Developers Console → your Channel → Messaging API tab → set your Webhook URL

  4. Invite the bot to a group or room in the LINE app (search by the bot's Basic ID @xxx shown in LINE Developers Console → Basic settings)

  5. To get the ID, receive the join event or any message event via Webhook — it will contain source.groupId (for groups) or source.roomId (for rooms)

No installation needed — just configure your MCP client.

DEFAULT_UID is optional. Set it when you want single-target messaging tools to use a default LINE User ID, so calls like push_text_message can omit to.

Codex CLI

codex mcp add @zients/line-mcp-server \
  --env CHANNEL_ACCESS_TOKEN=<your-token> \
  --env DEFAULT_UID=U... \
  -- npx -y @zients/line-mcp-server

Start a new Codex session after adding the MCP server so Codex loads the new tools.

Claude Code

claude mcp add @zients/line-mcp-server -t stdio \
  -e CHANNEL_ACCESS_TOKEN=<your-token> \
  -e DEFAULT_UID=U... \
  -- npx -y @zients/line-mcp-server

OpenClaw (mcporter)

mcporter config add @zients/line-mcp-server \
  --command npx \
  --arg -y --arg @zients/line-mcp-server \
  --env CHANNEL_ACCESS_TOKEN=<your-token> \
  --env DEFAULT_UID=U... \
  --description "LINE Messaging API tools"

Other MCP clients

Add the following to your MCP client configuration:

{
  "mcpServers": {
    "@zients/line-mcp-server": {
      "command": "npx",
      "args": ["-y", "@zients/line-mcp-server"],
      "env": {
        "CHANNEL_ACCESS_TOKEN": "<your-token>",
        "DEFAULT_UID": "U..."
      }
    }
  }
}

Setup (build from source)

git clone https://github.com/zients/line-mcp-server.git
cd line-mcp-server
npm install
npm run build   # compiles TypeScript to dist/

Codex CLI

codex mcp add @zients/line-mcp-server \
  --env CHANNEL_ACCESS_TOKEN=<your-token> \
  --env DEFAULT_UID=U... \
  -- node /path/to/line-mcp-server/dist/index.js

Claude Code

claude mcp add @zients/line-mcp-server -t stdio \
  -e CHANNEL_ACCESS_TOKEN=<your-token> \
  -e DEFAULT_UID=U... \
  -- node /path/to/line-mcp-server/dist/index.js

OpenClaw (mcporter)

mcporter config add @zients/line-mcp-server \
  --command node \
  --arg /path/to/line-mcp-server/dist/index.js \
  --env CHANNEL_ACCESS_TOKEN=<your-token> \
  --env DEFAULT_UID=U... \
  --description "LINE Messaging API tools"

Verify & call tools (mcporter)

mcporter list @zients/line-mcp-server --schema
mcporter call @zients/line-mcp-server.push_text_message to=U... text="Hello"
mcporter call @zients/line-mcp-server.push_text_message text="Hello from DEFAULT_UID"
mcporter call @zients/line-mcp-server.get_user_profile userId=U...
mcporter call @zients/line-mcp-server.get_bot_info

After registration, Claude can call LINE tools directly:

"Send 'Hello' to my LINE group C1234567890"

Target ID Prefixes

Prefix

Type

U...

User ID

C...

Group ID

R...

Room ID

Project Structure

src/
├── index.ts                          # Entry point (stdio MCP server)
├── services/
│   └── line.ts                       # LineService interface + LineMessagingClient
├── tools/
│   ├── messaging.ts                  # 12 messaging tools
│   ├── profile.ts                    # 2 profile tools
│   ├── group.ts                      # 8 group/room management tools
│   ├── richmenu.ts                   # 9 rich menu tools
│   └── insight.ts                    # 13 insight/analytics tools
└── utils/
    ├── error.ts                      # Error formatting utility
    ├── flex.ts                       # Flex message JSON validation
    └── target.ts                     # DEFAULT_UID parsing and target fallback

tests/
├── helpers/
│   └── mock-line-service.ts          # Shared mock LineService for all tests
├── integration/
│   └── server.test.ts                # MCP server integration test (all 44 tools)
├── services/
│   └── line.test.ts                  # LineMessagingClient unit tests
├── tools/
│   ├── messaging.test.ts             # Messaging tool handler tests
│   ├── profile.test.ts               # Profile tool handler tests
│   ├── group.test.ts                 # Group/room tool handler tests
│   ├── richmenu.test.ts              # Rich menu tool handler tests
│   └── insight.test.ts               # Insight tool handler tests
└── utils/
    ├── error.test.ts                 # Error formatting tests
    └── target.test.ts                # DEFAULT_UID and target fallback tests

Testing

npm test              # run all tests
npm run test:coverage # run with coverage report

Environment Variables

Variable

Required

Description

CHANNEL_ACCESS_TOKEN

Yes

LINE Messaging API channel access token

DEFAULT_UID

No

Default recipient User ID (must start with U). When set, the single-target messaging tools (push_text_message, push_image_message, push_sticker_message, push_flex_message, push_video_message, push_audio_message, push_location_message, show_loading_indicator) may omit to/chatId and send to this user by default. An explicit to (User/Group/Room) always overrides it. If set to a value that does not start with U, the server exits on startup.

License

MIT

Available Tools

44 tools
broadcast_flex_messageBroadcast Flex MessageA

Broadcast a Flex Message (rich layout) to ALL followers of the LINE Official Account. Use with caution.

Inputs: altText (required), contents (required).

broadcast_text_messageBroadcast Text MessageA

Broadcast a text message to ALL followers of the LINE Official Account. Use with caution.

Inputs: text (required).

cancel_default_rich_menuCancel Default Rich MenuC

Cancel the default rich menu.

Inputs: no named parameters.

create_rich_menuCreate Rich MenuB

Create a new rich menu. Pass the rich menu object as a JSON string.

Inputs: richMenu (required).

delete_rich_menuDelete Rich MenuA

Delete a rich menu by its ID.

Inputs: richMenuId (required).

get_bot_infoGet Bot InfoA

Get information about the LINE Official Account bot, including name, ID, chat mode, and mark-as-read mode.

Inputs: no named parameters.

get_default_rich_menuGet Default Rich MenuA

Get the ID of the default rich menu.

Inputs: no named parameters.

get_follower_idsGet Follower IDsA

Get a list of user IDs of users who have added the LINE Official Account as a friend. Supports pagination via the start token.

Inputs: start.

get_friend_demographicsGet Friend DemographicsA

Get demographic information about the LINE Official Account's friends, including gender, age, and area breakdowns.

Inputs: no named parameters.

get_group_member_countGet Group Member CountA

Get the number of members in a LINE group chat. The bot must be a member of the group.

Inputs: groupId (required).

get_group_member_idsGet Group Member IDsB

Get the user IDs of all members in a LINE group chat. The bot must be a member of the group.

Inputs: groupId (required).

get_group_member_profileGet Group Member ProfileA

Get a member's profile in a LINE group chat. The bot must be a member of the group.

Inputs: userId (required), groupId (required).

get_group_summaryGet Group SummaryB

Get a LINE group's name and picture URL. The bot must be a member of the group.

Inputs: groupId (required).

get_message_deliveriesGet Message DeliveriesB

Get the number of message deliveries on a specified date, including breakdowns by API type.

Inputs: date (required).

get_message_eventGet Message EventA

Get statistics about how users interact with messages, including impressions, clicks, and other engagement metrics.

Inputs: requestId (required).

get_message_quotaGet Message QuotaA

Get the message quota for the LINE Official Account, including the quota type and limit.

Inputs: no named parameters.

get_message_quota_consumptionGet Message Quota ConsumptionB

Get the number of messages sent this month for the LINE Official Account.

Inputs: no named parameters.

get_number_of_followersGet Number of FollowersA

Get the number of followers for the LINE Official Account on a specified date. Returns follower count, targeted reaches, and blocks.

Inputs: date (required).

get_rich_menuGet Rich MenuA

Get a rich menu by its ID.

Inputs: richMenuId (required).

get_room_member_countGet Room Member CountA

Get the number of members in a LINE multi-person chat room. The bot must be a member of the room.

Inputs: roomId (required).

get_room_member_idsGet Room Member IDsA

Get the user IDs of all members in a LINE multi-person chat room. The bot must be a member of the room.

Inputs: roomId (required).

get_room_member_profileGet Room Member ProfileA

Get a member's profile in a LINE multi-person chat room. The bot must be a member of the room.

Inputs: roomId (required), userId (required).

get_sent_broadcast_countGet Sent Broadcast Message CountA

Get the number of broadcast messages sent on a specified date.

Inputs: date (required).

get_sent_multicast_countGet Sent Multicast Message CountB

Get the number of multicast messages sent on a specified date.

Inputs: date (required).

get_sent_push_countGet Sent Push Message CountA

Get the number of push messages sent on a specified date.

Inputs: date (required).

get_sent_reply_countGet Sent Reply Message CountA

Get the number of reply messages sent on a specified date.

Inputs: date (required).

get_statistics_per_unitGet Statistics Per UnitC

Get statistics per custom aggregation unit for messages sent within a specified date range.

Inputs: to (required), from (required), customAggregationUnit (required).

get_user_profileGet User ProfileA

Get a LINE user's display name, picture URL, status message, and language.

Inputs: userId (required).

leave_groupLeave GroupA

Leave a LINE group chat. Bot will leave the group permanently.

Inputs: groupId (required).

leave_roomLeave RoomA

Leave a LINE multi-person chat room. Bot will leave the room permanently.

Inputs: roomId (required).

list_rich_menusList Rich MenusA

List all rich menus for the LINE Official Account.

Inputs: no named parameters.

multicast_flex_messageMulticast Flex MessageA

Send a Flex Message (rich layout) to multiple LINE users at once (max 500 user IDs).

Inputs: altText (required), userIds (required), contents (required).

multicast_text_messageMulticast Text MessageA

Send a text message to multiple LINE users at once (max 500 user IDs).

Inputs: text (required), userIds (required).

push_audio_messagePush Audio MessageA

Send an audio message to a LINE user, group, or room.

Inputs: duration (required), originalContentUrl (required), to.

push_flex_messagePush Flex MessageB

Send a Flex Message (rich layout) to a LINE user, group, or room. Pass the Flex container as a JSON string.

Inputs: altText (required), contents (required), to.

push_image_messagePush Image MessageA

Send an image to a LINE user, group, or room.

Inputs: previewImageUrl (required), originalContentUrl (required), to.

push_location_messagePush Location MessageA

Send a location message to a LINE user, group, or room.

Inputs: title (required), address (required), latitude (required), longitude (required), +1 more.

push_sticker_messagePush Sticker MessageA

Send a LINE sticker. See LINE sticker list for valid packageId/stickerId.

Inputs: packageId (required), stickerId (required), to.

push_text_messagePush Text MessageA

Send a text message to a LINE user, group, or room. Target ID prefixes: User="U", Group="C", Room="R".

Inputs: text (required), to.

push_video_messagePush Video MessageC

Send a video to a LINE user, group, or room.

Inputs: previewImageUrl (required), originalContentUrl (required), to.

set_default_rich_menuSet Default Rich MenuA

Set a rich menu as the default for all users.

Inputs: richMenuId (required).

show_loading_indicatorShow Loading IndicatorA

Display a loading animation in the LINE chat to indicate processing.

Inputs: chatId.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 44 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose, with clear prefixes for messaging (push, broadcast, multicast), retrieval (get), and management (create, delete, set, etc.). The target audience (user, group, room) is specified in descriptions, eliminating confusion. Parallel tools for groups and rooms are distinct by entity type.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case, using predictable prefixes like push_, get_, create_, list_, delete_, set_, cancel_, link_, unlink_, leave_, and show_. This uniformity makes the toolset easy to navigate and understand.

    Tool Count4/5

    With 44 tools, the server is on the heavier side, but the breadth of LINE Official Account functionality (messaging, rich menus, group/room management, analytics) justifies the count. Each tool serves a distinct purpose, and the structure is logical, so it does not feel excessive for the domain.

    Completeness4/5

    The toolset covers core messaging (push, broadcast, multicast), rich menu CRUD, group/room info, and analytics. However, there are notable gaps: reply messages are missing, and broadcast/multicast are only available for text and flex, not for image/video/audio/location/sticker. These are missing but workable around, so overall completeness is strong but not perfect.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      AI-powered MCP server for managing LINE Official Accounts. Send broadcasts, push messages, check analytics, manage rich menus — all through natural language via Claude, ChatGPT, or Cursor. 10 tools included: * Account info, friend count, message quota * Broadcast, push message, multicast * Delivery stats, user profiles, follower list * Rich menu management Supports 95M+ LINE users across Jap
      10
      MIT
    • A
      license
      A
      quality
      A
      maintenance
      MCP server that integrates the LINE Messaging API to enable AI agents to send messages and manage LINE Official Accounts.
      12
      2,722 npm
      802
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for LINE Messaging API — send messages, manage groups, rich menus, webhooks, and more through 25 tools.
      21 npm
      MIT