← Back to directory

LINE OA MCP Ultimate

Community

Operate your LINE Official Account from any AI agent — through natural language.

GitHub source repository ↗

★ 96 Stars Category · Collaboration Popular Source revision 9fdf27a1a08c

59FMRS · C

Reliability

8/20

Security and permissions

14/20

Maintenance

13/20

Documentation

13/20

Setup experience

11/20

Based on the README's objective description. The server offers rich features but requires careful token management.

Read the FMRS scoring method →

line-oa-mcp-ultimate is a Model Context Protocol (MCP) server that lets AI agents drive your LINE Official Account through natural conversation — no code, no API knowledge required. Manage one OA or many, with 51 tools (37 messaging + 14 shopping) plus resources and guided prompts. Works with Claude, Cursor, Codex, ChatGPT desktop, and any MCP-compatible host. This is an independent open-source project, not affiliated with or endorsed by LY Corporation / LINE Corp.

Tools

send_message

Send messages to LINE users/groups, supporting reply, push, multicast, narrowcast, and broadcast, with text, Flex, sticker, image, video, coupon, etc.

line_prepare_image

Automatically resizes your image to all required sizes and hosts it, verifying reachability before success.

line_image_host_status

Check the health of the image hosting service.

line_build_rich_menu

Create a rich menu (including image upload and set as default).

line_list_rich_menus

List all rich menus.

line_delete_rich_menu

Delete a specified rich menu.

line_diagnose_rich_menu

Diagnose why a user cannot see a rich menu.

line_link_rich_menu

Link a rich menu to specific users or in bulk.

line_unlink_rich_menu

Unlink a rich menu from users.

line_set_default_rich_menu

Set the account default rich menu.

line_clear_default_rich_menu

Clear the account default rich menu.

line_design_rich_menu_image

Generate a rich menu image with Thai-ready templates, with preview before deploying.

line_manage_rich_menu_alias

Manage rich menu aliases for tab-switching menus.

line_build_flex_message

Design Flex Messages from 8 Thai-localized templates or raw JSON.

line_build_rich_message

Build Rich Messages (imagemap) with tappable regions and optional video.

line_build_card_message

Build Card Messages (template) with buttons, confirm, carousel, etc.

line_manage_audience

Create, update, list, delete audiences.

line_create_audience_from_csv

Create an audience from a CSV file.

line_list_audiences

List all audiences.

line_delete_audience

Delete a specified audience.

line_update_audience

Add users to an existing audience or rename it.

line_get_oa_snapshot

Get OA status snapshot including friend count, monthly quota, webhook status, etc.

line_get_weekly_report

Generate weekly markdown report with message stats.

line_get_broadcast_stats

Get engagement stats for each broadcast.

line_estimate_send_cost

Estimate send cost and quota before sending.

line_get_narrowcast_progress

Check narrowcast delivery progress.

line_manage_coupon

Create, list, get, and discontinue native LINE coupons.

line_use_oa

Switch the active OA at runtime.

line_run_on_many_oas

Run a read-only tool across all client OAs in parallel.

line_get_user_profile

Get a user's profile.

line_list_friends

List followers.

line_manage_liff

Manage LIFF app lifecycle (create, update, delete, list).

line_verify_token

Verify channel access token validity, expiry, and scope.

line_test_webhook

Test the OA's webhook URL and show signature verification result.

line_set_webhook

Set the webhook endpoint.

line_get_webhook

Get the current webhook endpoint.

line_manage_product

Create, update, delete products.

line_list_products

List products.

line_update_product

Update product details.

line_delete_product

Delete a product.

line_change_product_price

Change a product's price.

line_show_hide_product

Show or hide a product from the store.

line_manage_product_variants

Manage product variants.

line_set_stock

Set, increase, or decrease stock.

line_list_orders

List or search orders.

line_get_order_detail

Get order details.

line_fulfill_order

Mark an order as shipped, print parcel labels, mark COD paid.

line_cancel_order

Cancel an order.

line_get_settlement

View settlements and actual income.

line_create_checkout_link

Create a checkout link to close the sale in chat.

Setup

Get your Channel Access Token from the LINE Developers Console.
Add the MCP server to your AI host's config file (e.g., Claude Desktop).
Restart your AI host completely (e.g., Cmd+Q on macOS).
Verify by asking: "Show my LINE OA status" or "ดูสถานะ OA หน่อย".
(Optional) For LINE Shopping, add LINE_MYSHOP_API_KEY to the env block.
For multi-OA, create ~/.line-mcp/config.json with each OA's credentials.

claude_desktop_config.json

{
  "mcpServers": {
    "line": {
      "command": "npx",
      "args": [
        "-y",
        "line-oa-mcp-ultimate"
      ],
      "env": {
        "LINE_CHANNEL_ACCESS_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Generate and validate client config

Fit and risk

Best for

AI-first marketers running a LINE OA from their AI workspace
SMB owners using LINE OA as their primary customer channel
Marketing agencies managing many client OAs from one dashboard
Developers building LINE-integrated SaaS, automations, or AI bots

Not for

Users who only need to push a simple text or Flex message to one user (the official LINE Bot MCP server may be simpler)
Users who prefer the LINE OA Manager web UI and do not want the extra complexity of an MCP server

Required permissions

LINE Channel Access Token with full messaging, menu, audience, and coupon permissions
Optional LINE MyShop API key for shopping tools

Risks and side effects

A leaked Channel Access Token could allow an attacker to fully control your OA, including sending spam or deleting menus
Sending large broadcasts may exceed LINE's quota limits
HTTP transport without authentication could expose the service
Image hosting depends on local machine or third-party services; if offline, images may become inaccessible

Troubleshooting

Ensure the Channel Access Token is valid and not expired; regenerate it from LINE Developers Console if needed
Check that the MCP config file is in the correct path and has valid JSON
Restart your AI host to load the new configuration
Review server logs for any startup errors
For HTTP transport, make sure MCP_HTTP_TOKEN is set
If image hosting fails, check network connectivity or provide a public HTTPS URL

Use cases

Broadcast marketing messages via natural language, e.g., 'Send a Mother's Day promo to my Bangkok-based 25-44 female audience'

Send an attached picture as a Rich Message with zero hosting setup

Create and manage rich menus, coupons, and audiences

Get weekly analytics reports and send cost estimates

Manage LINE Shopping products, inventory, orders, and settlements

Supported clients

Claude DesktopFull support

Claude CodeFull support

Claude CoworkFull support

CursorFull support

CodexFull support

ChatGPT DesktopFull support

OpenClawFull support

HermesFull support

Related MCP servers

Compare with other MCP servers