Home / MCP / Feishu MCP Server

Feishu MCP Server

Provides access to Feishu Project Open API data (views, items, roles) via MCP with stdio-based runtime

python

7stars

View on GitHub

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
    "mcpServers": {
        "feishuproj": {
            "command": "uvx",
            "args": [
                "mcp-feishu-proj@latest",
                "--transport",
                "stdio"
            ],
            "env": {
                "FS_PROJ_PROJECT_KEY": "your_project_key",
                "FS_PROJ_USER_KEY": "your_user_key",
                "FS_PROJ_PLUGIN_ID": "your_plugin_id",
                "FS_PROJ_PLUGIN_SECRET": "your_plugin_secret"
            }
        }
    }
}

You can run a Feishu project management MCP Server to let AI assistants interact with Feishu Project Open API, enabling you to view project views, view details, and manage work items through MCP-compatible clients.

How to use

You connect your MCP client to the Feishu project MCP Server by configuring the client to load the provided server configuration. This enables you to fetch project views, view items, and retrieve item details through standard MCP tooling.

How to install

Prerequisites: you need Python and the MCP client tooling available on your system (e.g., uvx). You also need a Feishu project and API credentials.

Step 1: Install the MCP runtime and dependencies.

Step 2: Add the Feishu MCP Server configuration to your MCP client config. Use the following snippet as the mcpServers entry.

{
  "mcpServers": {
    "feishuproj": {
      "command": "uvx",
      "args": ["mcp-feishu-proj@latest","--transport", "stdio"],
      "env": {
        "FS_PROJ_PROJECT_KEY": "your_project_key",
        "FS_PROJ_USER_KEY": "your_user_key",
        "FS_PROJ_PLUGIN_ID": "your_plugin_id",
        "FS_PROJ_PLUGIN_SECRET": "your_plugin_secret"
      }
    }
  }
}

Additional setup notes

Environment variables shown above must be set to your Feishu project credentials. You can place the configuration in your MCP client’s config file at the appropriate path for your OS.

Configuration and features

The server provides authentication, view-related operations, work item details, and metadata, with several features marked as planned or in progress.

Container and deployment notes

If you plan to deploy in containers or orchestration platforms, you can reuse the same environment variable keys and the uvx invocation as shown above. Ensure your deployment environment passes the FS_PROJ_* variables to the container.

Available tools

login

getViews

Fetch the list of Feishu project views.

getViewItems

Fetch the work items within a specific view.

getItemDetails

Retrieve detailed information for a specific work item.

getCreateItemMetadata

Obtain metadata necessary to create a new work item.

getProcessRoles

Retrieve process role configuration details for the project space.