Feishu User Plugin MCP Server

by ethanqcio.github.EthanQC/feishu-user-pluginv1.3.14

Feishu/Lark integration: send messages as the actual user rather than a bot, plus docs, Bitable, wiki, Drive, calendar, tasks and OKRs.

10Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing3mo ago

Install Feishu User Plugin MCP server

claude mcp add feishu-user-plugin -e LARK_COOKIE='<lark-cookie>' -e LARK_APP_SECRET='<lark-app-secret>' -e LARK_USER_ACCESS_TOKEN='<lark-user-access-token>' -e LARK_USER_REFRESH_TOKEN='<lark-user-refresh-token>' -- npx -y feishu-user-plugin

{
  "mcpServers": {
    "feishu-user-plugin": {
      "command": "npx",
      "args": [
        "-y",
        "feishu-user-plugin"
      ],
      "env": {
        "LARK_COOKIE": "<lark-cookie>",
        "LARK_APP_SECRET": "<lark-app-secret>",
        "LARK_USER_ACCESS_TOKEN": "<lark-user-access-token>",
        "LARK_USER_REFRESH_TOKEN": "<lark-user-refresh-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "feishu-user-plugin": {
      "command": "npx",
      "args": [
        "-y",
        "feishu-user-plugin"
      ],
      "env": {
        "LARK_COOKIE": "<lark-cookie>",
        "LARK_APP_SECRET": "<lark-app-secret>",
        "LARK_USER_ACCESS_TOKEN": "<lark-user-access-token>",
        "LARK_USER_REFRESH_TOKEN": "<lark-user-refresh-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "feishu-user-plugin": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "feishu-user-plugin"
      ],
      "env": {
        "LARK_COOKIE": "<lark-cookie>",
        "LARK_APP_SECRET": "<lark-app-secret>",
        "LARK_USER_ACCESS_TOKEN": "<lark-user-access-token>",
        "LARK_USER_REFRESH_TOKEN": "<lark-user-refresh-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "feishu-user-plugin": {
      "command": "npx",
      "args": [
        "-y",
        "feishu-user-plugin"
      ],
      "env": {
        "LARK_COOKIE": "<lark-cookie>",
        "LARK_APP_SECRET": "<lark-app-secret>",
        "LARK_USER_ACCESS_TOKEN": "<lark-user-access-token>",
        "LARK_USER_REFRESH_TOKEN": "<lark-user-refresh-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
LARK_COOKIE	—	yes	Feishu web session cookie. Required for user-identity messaging tools (send_to_user, send_as_user, etc).
LARK_APP_ID	—	—	Feishu Open Platform self-built app App ID (cli_xxxxxxxxxxxx). Required for Official API tools (docs, bitable, wiki, drive, calendar, tasks, OKR, group messaging).
LARK_APP_SECRET	—	yes	Feishu Open Platform self-built app App Secret. Used together with LARK_APP_ID.
LARK_USER_ACCESS_TOKEN	—	yes	User OAuth UAT for P2P chat reading and as user-owner on resource creation. Obtained via 'npx feishu-user-plugin oauth'.
LARK_USER_REFRESH_TOKEN	—	yes	Refresh token for UAT auto-renewal.

Freshness

Slowing — last maintenance signal 3mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-07-06 · 3mo ago · GitHub
Latest release
2026-05-10 · 5mo ago · GitHub · v1.3.11
Package published
no data · npm/PyPI
Registry entry updated
2026-05-22 · 5mo ago · official registry · v1.3.14

FAQ

›How do I install the Feishu User Plugin MCP server in Claude Code?

Run: claude mcp add feishu-user-plugin -e LARK_COOKIE='<lark-cookie>' -e LARK_APP_SECRET='<lark-app-secret>' -e LARK_USER_ACCESS_TOKEN='<lark-user-access-token>' -e LARK_USER_REFRESH_TOKEN='<lark-user-refresh-token>' -- npx -y feishu-user-plugin. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Feishu User Plugin require an API key?

Yes. It expects LARK_COOKIE, LARK_APP_SECRET, LARK_USER_ACCESS_TOKEN, LARK_USER_REFRESH_TOKEN, of which 4 are secrets.

›Can I use Feishu User Plugin as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Feishu User Plugin in the official MCP registry?

Yes, as io.github.EthanQC/feishu-user-plugin.