How to add LINE Bot MCP Server to Windsurf

Connect AI agents to a LINE Official Account via the LINE Messaging API. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 599★ · stdio · apikey · official

Windsurf config for LINE Bot MCP Server

npx @line/line-bot-mcp-server

{
  "mcpServers": {
    "line-bot-mcp-server": {
      "command": "npx",
      "args": [
        "@line/line-bot-mcp-server"
      ],
      "env": {
        "NPM_CONFIG_IGNORE_SCRIPTS": "true",
        "CHANNEL_ACCESS_TOKEN": "FILL_HERE",
        "DESTINATION_USER_ID": "FILL_HERE"
      }
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the LINE Bot MCP Server config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5LINE Bot MCP Server's tools become available to Cascade.

Before you start

Node.js v22 or later (for the npx installation)
A LINE Official Account with the Messaging API enabled
A LINE Channel Access Token (CHANNEL_ACCESS_TOKEN)
Optionally a default recipient user ID (DESTINATION_USER_ID)

What LINE Bot MCP Server can do in Windsurf

push_text_message

Push a simple text message to a user via LINE. Recipient defaults to DESTINATION_USER_ID if userId is not provided.

push_flex_message

Push a highly customizable flex message (bubble or carousel) to a user via LINE, with required alt text.

broadcast_text_message

Broadcast a simple text message to all users who have followed your LINE Official Account.

broadcast_flex_message

Broadcast a highly customizable flex message (bubble or carousel) to all users who have added your LINE Official Account.

get_profile

Get detailed profile information of a LINE user including display name, profile picture URL, status message, and language.

get_message_quota

Get the message quota and consumption of the LINE Official Account, showing the monthly message limit and current usage.

get_rich_menu_list

Get the list of rich menus associated with your LINE Official Account.

delete_rich_menu

Delete a rich menu from your LINE Official Account by richMenuId.

Security

Requires a LINE Channel Access Token (CHANNEL_ACCESS_TOKEN) passed as an environment variable; treat it as a secret. The npx config sets NPM_CONFIG_IGNORE_SCRIPTS=true to skip package install scripts. Broadcast tools send messages to all followers of the Official Account, so use with care.

LINE Bot MCP Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the LINE Bot MCP Server config there under the "mcpServers" key and restart the client.

Is LINE Bot MCP Server safe to use with Windsurf?

Is this an official LINE project?

Yes. It is published by the LINE organization on GitHub and distributed as the @line/line-bot-mcp-server npm package. It is currently provided as a preview version.

What credentials do I need?

A LINE Channel Access Token (CHANNEL_ACCESS_TOKEN) is required. A DESTINATION_USER_ID is optional but required when a tool's input does not include a userId.

How can I run it?

Via npx with @line/line-bot-mcp-server (requires Node.js v22+), or via a Docker image you build from the repository. Both are configured as an mcpServers entry in your AI agent.

View repo Full LINE Bot MCP Server page