[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-82189":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":16,"forks30d":16,"starsTrendScore":15,"compositeScore":19,"rankGlobal":10,"rankLanguage":10,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":21,"hasPages":21,"topics":23,"createdAt":10,"pushedAt":10,"updatedAt":39,"readmeContent":40,"aiSummary":41,"trendingCount":16,"starSnapshotCount":16,"syncStatus":42,"lastSyncTime":43,"discoverSource":44},82189,"line-oa-mcp-ultimate","wasintoh\u002Fline-oa-mcp-ultimate","wasintoh","Talk to your LINE Official Account through AI. 27 tools for broadcasts, audiences, rich menus, Flex messages, coupons & insights — works with Claude Cowork, Claude Code, Cursor, and any MCP-compatible host. Zero infrastructure, free-tier ready.","https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fline-oa-mcp-ultimate",null,"TypeScript",61,20,23,1,0,3,38,3.97,"MIT License",false,"main",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38],"ai-agent","claude","claude-mcp","cursor","line","line-bot","line-messaging-api","line-oa","line-official-account","marketing-automation","mcp","mcp-server","model-context-protocol","thai","typescript","2026-06-12 02:04:24","\u003Cdiv align=\"center\">\n\n# LINE OA MCP Ultimate\n\n**Operate your LINE Official Account from any AI agent — through natural language.**\n\n[![npm version](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fline-oa-mcp-ultimate.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fline-oa-mcp-ultimate)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue.svg)](LICENSE)\n[![Node.js](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnode-%E2%89%A520-brightgreen.svg)](#requirements)\n[![MCP](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMCP-1.x-purple.svg)](https:\u002F\u002Fmodelcontextprotocol.io)\n\n[Quick Start](#quick-start) · [What you can do](#what-you-can-do) · [Configuration](#configuration) · [Documentation](#documentation)\n\n\u003C\u002Fdiv>\n\n---\n\n## What is this?\n\n`line-oa-mcp-ultimate` is a [Model Context Protocol](https:\u002F\u002Fmodelcontextprotocol.io) server that lets AI agents drive your LINE Official Account through natural conversation — no code, no API knowledge required.\n\nIt works with **Claude Cowork, Claude Code, Cursor, Codex, ChatGPT desktop**, or any MCP-compatible host.\n\n> **Disclaimer:** This is an independent open-source project. It is **not affiliated with or endorsed by LY Corporation \u002F LINE Corp**. \"LINE\" is a registered trademark of LY Corporation, used here in a descriptive sense.\n\n---\n\n## Why use it?\n\nLINE OA Manager works well — but it's a web UI you have to log into, click through, and operate manually. With this MCP server, the same operations become natural-language requests in your AI host of choice:\n\n| Instead of clicking through LINE OA Manager... | Just say... |\n|---|---|\n| Open broadcast composer → pick audience → write text → preview → schedule | \"Send a Mother's Day promo to my Bangkok-based 25-44 female audience\" |\n| Navigate Insight → Delivery → pick date range → screenshot | \"Summarize last week's performance\" |\n| Open Audience → create from upload → upload CSV → wait | \"Create an audience from this CSV: customers_last_month.csv\" |\n| Open Rich Menu → design tabs → upload images → set as default | \"Build a Mother's Day rich menu and set it as default\" |\n| Open Coupon → check usage tab → cross-reference clicks | \"How many people redeemed my Mother's Day coupon?\" |\n\nThe MCP server takes care of LINE Messaging API calls, pre-flight validation, quota safety, quiet-hour warnings, and Thai-localized templates. You stay in your AI host and operate your OA the way you think about it — by intent.\n\n---\n\n## Who is it for?\n\n- 🪐 **AI-first marketers** who run a LINE OA from their AI workspace.\n- 🏪 **SMB owners** who already use LINE OA as their primary customer channel and want to automate routine work.\n- 🏢 **Marketing agencies** managing many client OAs from one dashboard.\n- 💻 **Developers** building LINE-integrated SaaS, automations, or AI bots.\n\n**Free-tier ready** — no Premium upgrade required for the core feature set.\n\n---\n\n## What you can do\n\n**27 tools + 4 resources + 7 guided prompts**, grouped by what you actually want to do:\n\n### 📨 Send messages (3 tools)\nOne universal `send_message` covers every LINE transport (reply \u002F push \u002F multicast \u002F narrowcast \u002F broadcast). Three modes: `send_now`, `draft` (for scheduling via LINE OA Manager UI), and `dry_run` (validate + estimate cost without sending). Includes typing indicator and Thai-friendly sticker search.\n\n### 🎨 Rich Menus (4 tools)\nBuild a rich menu in one call — create + upload image + set as default. List existing menus, delete with cleanup, or diagnose \"why doesn't this user see my menu?\".\n\n### 💎 Flex Messages (1 tool)\nDesign Flex Messages from 8 Thai-localized templates (receipt, voucher, shipping update, promo, thank you, ...) or raw JSON. Returns ready-to-send Flex JSON plus a LINE Flex Simulator preview URL.\n\n### 🎯 Audiences (4 tools)\nBuild retargeting audiences from a CSV or from prior broadcast engagement (people who clicked your previous send). The audience your CRM never had.\n\n### 📊 Insights (4 tools)\nQuick OA status snapshot, weekly markdown reports, per-broadcast engagement stats, and pre-flight send cost estimation.\n\n### 🎟 Coupons (2 tools)\nCreate, list, get, and discontinue coupons. Pull redemption analytics by combining coupon details with click-audience tracking.\n\n### 🔌 Webhook (1 tool)\nTest your OA's webhook URL and surface LINE's signature verification result — quick to diagnose \"why isn't my bot responding?\".\n\n### 👤 Operations (5 tools)\nUser profile lookup, follower listing, multi-OA listing and switching, and `run_on_many_oas` for agencies that need to run a read-only tool across all client OAs in parallel.\n\n### 💻 Developer Pack (3 tools)\nLIFF lifecycle management plus code generators for LIFF SDK init (5 frameworks) and a full LINE Login OAuth scaffold.\n\n**Resources** — auto-refreshing OA snapshot, Flex template catalog, sticker catalog with mood-keyword index, and a Thai festival calendar with marketing promo patterns.\n\n**Prompts** — guided workflows for daily reports, campaign building, broadcast scheduling, rich menu diagnosis, coupon campaigns, LINE Notify migration, and webhook setup.\n\n---\n\n## Quick Start\n\n### Requirements\n\n- **Node.js 20 or later**\n- A LINE Official Account with Messaging API enabled\n- A Channel Access Token\n\nNo database, no Playwright, no CDN, no public URL, no scheduler infrastructure required.\n\n### Step 1 — Get your Channel Access Token\n\n1. Open the [LINE Developers Console](https:\u002F\u002Fdevelopers.line.biz\u002Fconsole\u002F).\n2. Pick your provider → open (or create) a **Messaging API channel**.\n3. Open the **Messaging API** tab → scroll to **Channel access token** → click **Issue**.\n4. Copy the long-lived token. Treat it like a password.\n\nIf you don't yet have a LINE Official Account, follow [LINE's getting started guide](https:\u002F\u002Fdevelopers.line.biz\u002Fen\u002Fdocs\u002Fmessaging-api\u002Fgetting-started\u002F).\n\n### Step 2 — Add the MCP server to your AI host\n\nPaste the following block into your host's MCP config file (see table below):\n\n```json\n{\n  \"mcpServers\": {\n    \"line\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"line-oa-mcp-ultimate\"],\n      \"env\": {\n        \"LINE_CHANNEL_ACCESS_TOKEN\": \"YOUR_TOKEN_HERE\"\n      }\n    }\n  }\n}\n```\n\n**Where to find the config file:**\n\n| Host | Where to add it |\n|---|---|\n| **Claude Cowork** | Settings → **Developer** → Local MCP servers → **Edit Config** |\n| **Claude Desktop** (macOS) | `~\u002FLibrary\u002FApplication Support\u002FClaude\u002Fclaude_desktop_config.json` |\n| **Claude Desktop** (Windows) | `%APPDATA%\\Claude\\claude_desktop_config.json` |\n| **Claude Code** | Run `claude mcp add line` or edit `~\u002F.config\u002Fclaude\u002Fmcp.json` |\n| **Cursor \u002F Codex \u002F ChatGPT desktop** | See your host's MCP setup docs — same JSON shape |\n\n> ⚠️ **Don't replace existing MCP servers.** Add the `\"line\"` entry alongside any existing entries inside `mcpServers`.\n\n### Step 3 — Restart your AI host\n\nQuit completely (Cmd+Q on macOS) and reopen. On first start the host runs `npx -y line-oa-mcp-ultimate`, downloads the package from npm, and caches it for subsequent starts.\n\n### Step 4 — Verify\n\nIn a new chat, try:\n\n```\nShow my LINE OA status\n```\n\nor in Thai:\n\n```\nดูสถานะ OA หน่อย\n```\n\nYou should see a health card with friend count, monthly quota, webhook status, and the default rich menu. That's it — you're now operating your LINE OA from your AI agent.\n\n---\n\n## Configuration\n\n### Single-OA mode (default — for most users)\n\nThat's the **Step 2** snippet above. One environment variable, one OA. Suitable for individual creators, course makers, and most SMB owners.\n\n### Multi-OA mode (for agencies)\n\nIf you manage several LINE OAs (your own plus client accounts), copy the `config.example.json` shipped with this repo to your home directory:\n\n```bash\nmkdir -p ~\u002F.line-mcp\ncp config.example.json ~\u002F.line-mcp\u002Fconfig.json\n```\n\nOpen `~\u002F.line-mcp\u002Fconfig.json` and fill in one entry per OA:\n\n```json\n{\n  \"default_oa\": \"main\",\n  \"oas\": {\n    \"main\": {\n      \"channel_access_token\": \"TOKEN_1\",\n      \"display_name\": \"Main OA\",\n      \"region\": \"TH\"\n    },\n    \"client_a\": {\n      \"channel_access_token\": \"TOKEN_2\",\n      \"display_name\": \"Client A — Bangkok Cafe\"\n    }\n  }\n}\n```\n\nThen **drop the `LINE_CHANNEL_ACCESS_TOKEN` env var** from your MCP config — the server discovers `~\u002F.line-mcp\u002Fconfig.json` automatically.\n\nResolution order:\n\n1. `LINE_MCP_CONFIG` env var (custom path)\n2. `~\u002F.line-mcp\u002Fconfig.json`\n3. `LINE_CHANNEL_ACCESS_TOKEN` env var (single-OA fallback)\n\n### Switching the active OA at runtime\n\nAsk your AI host:\n\n```\n\"Switch to client_a\"\n→ line_use_oa({ oa_id: \"client_a\" })\n```\n\nOr override per-call with the `oa` parameter on any tool.\n\n### Advanced — HTTP transport (self-hosted)\n\nFor agencies running a shared remote instance, the server also supports Streamable HTTP. See [docs\u002Fhttp-transport.md](docs\u002Fhttp-transport.md).\n\n---\n\n## Documentation\n\n| Doc | What's in it |\n|---|---|\n| [docs\u002Fquickstart-th.md](docs\u002Fquickstart-th.md) | Thai-language quick start (5-minute walkthrough) |\n| [docs\u002Fmulti-oa-setup-th.md](docs\u002Fmulti-oa-setup-th.md) | Multi-OA configuration guide (Thai) |\n| [docs\u002Fhttp-transport.md](docs\u002Fhttp-transport.md) | Streamable HTTP transport for self-hosted \u002F remote use |\n| [examples\u002F](examples\u002F) | Runnable examples |\n\n---\n\n## Versioning\n\nThis project follows [Semantic Versioning](https:\u002F\u002Fsemver.org\u002F). Current release: **v1.0.0**.\n\n---\n\n## Roadmap\n\n- **v1.x** — Outbound operations (current).\n- **v2.x** — Companion inbound package: webhook ingestion, chat 1:1 reply, auto-reply rules, greeting messages, chat tags.\n- **v3.x** — Hosted SaaS for agency multi-tenant use.\n\n---\n\n## Contributing\n\nPRs are welcome. Please open an issue first to discuss substantial changes.\n\nWhen contributing:\n\n- Tool names: `line_{action}_{resource}` (snake_case, prefix `line_`).\n- Tool descriptions: English (for LLMs) — Thai examples encouraged.\n- User-facing strings: Thai-friendly (centralized in `src\u002Fi18n\u002Fth.ts`).\n- Pre-flight validation on every send tool.\n- Quota Guardian + Quiet Hours on every consumption tool.\n\n---\n\n## Author\n\n**Dr. Wasin Treesinthuros** (พี่โต \u002F Dr. Wasin \u002F #จารโต)\n\n- CEO at Innovation Vantage\n- Founder at ForgeAI — AI Transformation Studio\n- LINE Certified Coach 2026\n- AI Transformation educator, SaaS builder, university lecturer\n\nThis project is part of a broader mission to bring production-grade AI automation to every Thai practitioner — regardless of technical background.\n\nGitHub: [@wasintoh](https:\u002F\u002Fgithub.com\u002Fwasintoh)\n\n---\n\n## License\n\n[MIT](LICENSE) © Dr. Wasin Treesinthuros — Innovation Vantage \u002F ForgeAI\n","`line-oa-mcp-ultimate` 项目通过 AI 与你的 LINE 官方账号进行交互，提供了27种工具来处理广播、受众管理、丰富菜单、Flex 消息、优惠券及数据分析等功能。它基于 Model Context Protocol (MCP) 构建，支持包括 Claude Cowork, Claude Code, Cursor 在内的多种 MCP 兼容主机，无需任何基础设施或编程知识即可使用。此项目特别适合希望通过自然语言指令在AI工作空间中管理LINE官方账号的营销人员、中小企业主以及营销代理机构。此外，对于希望构建集成LINE服务的SaaS产品或自动化流程的开发者来说也是一个很好的选择。项目采用TypeScript编写，并遵循MIT许可协议，提供免费层级的基础功能集。",2,"2026-06-11 04:08:00","CREATED_QUERY"]