@zients/line-mcp-server

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

Prerequisites

Node.js >= 22
A LINE Official Account with Messaging API enabled
Channel Access Token

Create a LINE Official Account

Go to LINE Official Account Manager and create an account
Go to LINE Developers Console and log in
Create a Provider (or select an existing one)
Under the Provider, create a Messaging API Channel linked to your Official Account
Go back to LINE Developers Console, select your Provider and Channel
In the Basic settings tab, find Your user ID (U...) — for testing push messages to yourself
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:

In LINE Official Account Manager → Settings → Account settings → enable Allow bot to join groups
In LINE Official Account Manager → Settings → Response settings → enable Webhook
In LINE Developers Console → your Channel → Messaging API tab → set your Webhook URL
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)
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)

Setup (npx — recommended)

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

Name		Name	Last commit message	Last commit date
Latest commit History 11 Commits
.github/workflows		.github/workflows
src		src
tests		tests
.env.example		.env.example
.gitignore		.gitignore
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json
vitest.config.ts		vitest.config.ts

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

@zients/line-mcp-server

Features

Messaging (12 tools)

Profile (2 tools)

Group & Room Management (8 tools)

Rich Menu (9 tools)

Insight & Analytics (13 tools)

Prerequisites

Create a LINE Official Account

Enable Group/Room Features (Optional)

Setup (npx — recommended)

Codex CLI

Claude Code

OpenClaw (mcporter)

Other MCP clients

Setup (build from source)

Codex CLI

Claude Code

OpenClaw (mcporter)

Verify & call tools (mcporter)

Target ID Prefixes

Project Structure

Testing

Environment Variables

License

About

Uh oh!

Releases 2

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

@zients/line-mcp-server

Features

Messaging (12 tools)

Profile (2 tools)

Group & Room Management (8 tools)

Rich Menu (9 tools)

Insight & Analytics (13 tools)

Prerequisites

Create a LINE Official Account

Enable Group/Room Features (Optional)

Setup (npx — recommended)

Codex CLI

Claude Code

OpenClaw (mcporter)

Other MCP clients

Setup (build from source)

Codex CLI

Claude Code

OpenClaw (mcporter)

Verify & call tools (mcporter)

Target ID Prefixes

Project Structure

Testing

Environment Variables

License

About

Topics

Resources

License

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases 2

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages