@zients/line-mcp-server

![npm version](https://www.npmjs.com/package/@zients/line-mcp-server) ![CI](https://github.com/zients/line-mcp-server/actions/workflows/ci.yml) ![Node.js](https://nodejs.org) ![License: MIT](./LICENSE)

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

@zients/line-mcp-server