Lark Doc

Provides access to Lark Doc and Wiki content via an OAuth-secured MCP server for retrieval and search.

javascript

3

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "t0ugh-mcp_server_my_lark_doc": {
      "command": "uvx",
      "args": [
        "mcp-server-my-lark-doc"
      ],
      "env": {
        "OAUTH_HOST": "localhost",
        "OAUTH_PORT": "9997",
        "LARK_APP_ID": "your app id",
        "LARK_APP_SECRET": "your app secret"
      }
    }
  }
}

You run a dedicated MCP server to search and access Lark (Feishu) documents through a simple, OAuth-secured interface. It supports both Doc and Wiki types, returns raw text content for processing by large language models, and includes automatic token handling and clear error feedback.

How to use

You interact with the MCP server through your MCP client by starting the server locally and then issuing content retrieval or search requests. Two primary actions are available: get_lark_doc_content to fetch document content from a specific Lark document, and search_wiki to find wiki documents matching your query. Both actions return plain text or structured JSON suitable for downstream processing by your application.

How to install

Prerequisites: ensure you have a runtime environment capable of running MCP servers (the examples use the uvx runtime). Install the MCP runtime if required by your environment, and make sure the command line tool is available on your PATH.

Install and start the MCP server with the following command:

uvx mcp-server-my-lark-doc

Configuration and usage details

Set up your Lark application credentials and OAuth callback settings in your environment before starting the server. You need your Lark App ID and App Secret, plus the OAuth callback host and port.

export LARK_APP_ID="your_app_id"
export LARK_APP_SECRET="your_app_secret"
export OAUTH_HOST="localhost"               # OAuth callback server host (default: localhost)
export OAUTH_PORT="9997"                   # OAuth callback server port (default: 9997)

Security and authentication

Authentication uses OAuth-based user authentication with automatic token refresh and expiration handling. The server expects your Lark app credentials to be configured in the environment and will manage access tokens for you.

Important: ensure your Lark app has the required permissions to access documents and wiki content as described in the permission notes.

Troubleshooting and common errors

If you encounter authentication or content access issues, verify that your Lark App ID and App Secret are correctly set and that your tokens are valid. Common errors include missing or invalid OAuth credentials, document access permissions, or misformatted document URLs.

If a document cannot be retrieved, check that the document exists, you have the proper permissions, and the URL is valid.

Notes on usage with Claude desktop

Configure your Claude desktop client to point to the MCP server using the mcpServers configuration. You will specify the command and any necessary environment variables for your Lark credentials.

Available tools

get_lark_doc_content

Retrieve document content from Lark using a document URL. Supports both Doc and Wiki URLs and returns the content in plain text for processing by your application.

search_wiki

Search documents in Lark Wiki with a query and optional page size, returning results with title, url, create_time, and update_time in JSON.