← Back to directory
L

LINE OA MCP Ultimate

Community
Operate your LINE Official Account from any AI agent — through natural language.
Category
Collaboration #12 of 55
Stars
★ 102 Popular
Transport
stdio (local process) · Streamable HTTP
Runtime
Node.js 20+
Credentials
API key / credential required
License
MIT
Last commit
Tools
50
59FMRS · C

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

Strongest · Security and permissions 14/20 Weakest · Reliability 8/20

Reliability
8/20
Security and permissions
14/20
Maintenance
13/20
Documentation
13/20
Setup experience
11/20
Why each score
Reliability 8/20
The repository includes structured TypeScript source, a test directory (tests/helpers, tests/) with coverage for key paths, and CI workflows (.github/workflows/test.yml, release.yml). Tests use vitest and mock LINE API at the fetch boundary, covering critical paths of the 51 tools. CI runs typecheck, tests (including coverage ≥80%), and build on Node 20 and 22. The 2.2.1 fix for HTTP mode 500 errors indicates responsiveness to production issues. However, since nothing was executed, full reliability verification is lacking; evidence of consistency between tool names and implementation details (e.g., tool list files) is insufficient, requiring a static deduction.
Security and permissions 14/20
The security posture is good: tokens are handled via env vars or config files, documentation recommends treating them like passwords; HTTP transport requires MCP_HTTP_TOKEN for non-localhost binding; there is a SECURITY.md with responsible disclosure process; clear threat model documentation is provided. However, there is no code-level verification: no check for hardcoded tokens or log leakage; least privilege, confirmation of dangerous operations (e.g., delete, send, pay) is not explicitly verified in code. README examples use placeholders; no real tokens found.
Maintenance 13/20
The project is active with recent versions (v2.2.2), detailed CHANGELOG, CI/CD automated releases with npm provenance, coverage-gated tests, and a clear contributing guide requiring tests. No obvious issue response records, but active development, versioning, release process, and clear authorship with MIT license indicate good maintenance. Deduction for missing direct evidence of dependency update frequency and issue close times.
Documentation 13/20
Documentation is extensive: comprehensive README covering quick start, configuration, multi-OA, HTTP transport, security, version history; Thai guides (quickstart, messaging, myshop etc.); per-tool descriptions; SECURITY.md and CHANGELOG. However, major docs are in Thai, English docs are fewer; installation details have examples but not verified; troubleshooting is mainly in Thai; missing API parameter-level documentation (e.g., per-tool parameter lists) and limitations sections.
Setup experience 11/20
Installation path is clear: npx command, client config JSON examples for Claude Desktop, Claude Code, Cursor etc.; supports stdio and HTTP transports; tokens via env vars; quick start guide. No database or external services required. However, Node.js 20 is required, which may be a requirement for some; multi-OA config requires manual JSON file creation; verification step relies on natural language prompts without a clear tool list; since static review, actual installation smoothness cannot be confirmed.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the networkChanges third-party account data

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

Setup

Before you start

Runtime:Node.js 20+

LINE_CHANNEL_ACCESS_TOKEN requiredsecret Long-lived Channel Access Token for your LINE Messaging API channel, issued in the LINE Developers Console (Messaging API tab → Issue).
LINE_MYSHOP_API_KEY optionalsecret Optional key that unlocks the 14 LINE Shopping tools; get it from oaplus.line.biz → Settings → API keys (Admin role required).
MCP_HTTP_TOKEN optionalsecret Bearer token required when running the HTTP transport on a non-loopback host; without it the server only binds to 127.0.0.1.
Other optional settings (1)
LINE_MCP_CONFIG optional Optional custom path to a multi-OA config file; by default the server auto-discovers ~/.line-mcp/config..
  1. Get your Channel Access Token from the LINE Developers Console.
  2. Add the MCP server to your AI host's config file (e.g., Claude Desktop).
  3. Restart your AI host completely (e.g., Cmd+Q on macOS).
  4. Verify by asking: "Show my LINE OA status" or "ดูสถานะ OA หน่อย".
  5. (Optional) For LINE Shopping, add LINE_MYSHOP_API_KEY to the env block.
  6. 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"
      }
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json
{
  "servers": {
    "line": {
      "command": "npx",
      "args": [
        "-y",
        "line-oa-mcp-ultimate"
      ],
      "env": {
        "LINE_CHANNEL_ACCESS_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add line -e LINE_CHANNEL_ACCESS_TOKEN=YOUR_TOKEN_HERE -- npx -y line-oa-mcp-ultimate

Run it in a terminal; replace any <…> placeholders with your own values first.

Check that it works

Restart your AI host, then in a new chat ask "Show my LINE OA status" — you should get a health card with friend count, monthly quota, webhook status, and the default rich menu, proving the connection works.

Troubleshooting

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

Things to try

Once connected, you can ask your AI assistant things like:

  • Show my LINE OA status
  • Summarize last week's broadcast performance
  • Send this attached picture to all customers as a Rich Message
  • Build a Mother's Day rich menu and set it as default

Tools 50

send_message destructive
Send messages to LINE users/groups, supporting reply, push, multicast, narrowcast, and broadcast, with text, Flex, sticker, image, video, coupon, etc.
line_prepare_image writes
Automatically resizes your image to all required sizes and hosts it, verifying reachability before success.
line_image_host_status read-only
Check the health of the image hosting service.
line_build_rich_menu writes
Create a rich menu (including image upload and set as default).
line_list_rich_menus read-only
List all rich menus.
line_delete_rich_menu destructive
Delete a specified rich menu.
line_diagnose_rich_menu read-only
Diagnose why a user cannot see a rich menu.
line_link_rich_menu writes
Link a rich menu to specific users or in bulk.
Show 42 more tools
line_unlink_rich_menu writes
Unlink a rich menu from users.
line_set_default_rich_menu writes
Set the account default rich menu.
line_clear_default_rich_menu writes
Clear the account default rich menu.
line_design_rich_menu_image writes
Generate a rich menu image with Thai-ready templates, with preview before deploying.
line_manage_rich_menu_alias writes
Manage rich menu aliases for tab-switching menus.
line_build_flex_message read-only
Design Flex Messages from 8 Thai-localized templates or raw JSON.
line_build_rich_message read-only
Build Rich Messages (imagemap) with tappable regions and optional video.
line_build_card_message read-only
Build Card Messages (template) with buttons, confirm, carousel, etc.
line_manage_audience writes
Create, update, list, delete audiences.
line_create_audience_from_csv writes
Create an audience from a CSV file.
line_list_audiences read-only
List all audiences.
line_delete_audience destructive
Delete a specified audience.
line_update_audience writes
Add users to an existing audience or rename it.
line_get_oa_snapshot read-only
Get OA status snapshot including friend count, monthly quota, webhook status, etc.
line_get_weekly_report read-only
Generate weekly markdown report with message stats.
line_get_broadcast_stats read-only
Get engagement stats for each broadcast.
line_estimate_send_cost read-only
Estimate send cost and quota before sending.
line_get_narrowcast_progress read-only
Check narrowcast delivery progress.
line_manage_coupon writes
Create, list, get, and discontinue native LINE coupons.
line_use_oa writes
Switch the active OA at runtime.
line_run_on_many_oas read-only
Run a read-only tool across all client OAs in parallel.
line_get_user_profile read-only
Get a user's profile.
line_list_friends read-only
List followers.
line_manage_liff writes
Manage LIFF app lifecycle (create, update, delete, list).
line_verify_token read-only
Verify channel access token validity, expiry, and scope.
line_test_webhook read-only
Test the OA's webhook URL and show signature verification result.
line_set_webhook writes
Set the webhook endpoint.
line_get_webhook read-only
Get the current webhook endpoint.
line_manage_product writes
Create, update, delete products.
line_list_products read-only
List products.
line_update_product writes
Update product details.
line_delete_product destructive
Delete a product.
line_change_product_price writes
Change a product's price.
line_show_hide_product writes
Show or hide a product from the store.
line_manage_product_variants writes
Manage product variants.
line_set_stock writes
Set, increase, or decrease stock.
line_list_orders read-only
List or search orders.
line_get_order_detail read-only
Get order details.
line_fulfill_order writes
Mark an order as shipped, print parcel labels, mark COD paid.
line_cancel_order destructive
Cancel an order.
line_get_settlement read-only
View settlements and actual income.
line_create_checkout_link writes
Create a checkout link to close the sale in chat.

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 Desktop
Claude Code
Claude Cowork
Cursor
Codex
ChatGPT
OpenClaw
Hermes

Listed from the project's documentation, not tested by this site.

Overview

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.

Similar servers

Source revision 9fdf27a1a08c Data synced 2026-10-11 Read the FMRS scoring method