mcp-server-my-lark-doc 0.1.1

A Model Context Protocol server for accessing Lark documents

MCP Server My Lark Doc

A Model Context Protocol server for searching and accessing Lark(Feishu) documents.

Features

Document Content Access

• Supports both Lark Doc and Wiki document types
• Automatically handles document type detection and ID extraction
• Returns raw content in text format for LLM processing

Authentication

• Supports both tenant access token and user access token
• Provides API to set user access token dynamically
• Automatically handles token refresh and management

Error Handling

• Comprehensive error reporting for authentication issues
• Clear feedback for invalid document URLs
• Detailed error messages for troubleshooting

Installation

uvx mcp-server-my-lark-doc

Configuration

Get your Lark App ID and App Secret

Visit the Lark Open Platform: https://open.larkoffice.com/app

Make Sure your Lark App has Permissions below

wiki:wiki:readonly
wiki:node:read
docx:document:readonly
search:docs:read

Environment Variables

Before using this MCP server, you need to set up your Lark application credentials:

1. Create a Lark application in Lark Open Platform
2. Get your App ID and App Secret
3. Configure environment variables:

export LARK_APP_ID="your_app_id"
export LARK_APP_SECRET="your_app_secret"

Usage

Configure in Claude desktop:

"mcpServers": {
    "lark_doc": {
        "command": "uvx",
        "args": ["mcp-server-my-lark-doc"],
        "env": {
            "LARK_APP_ID": "your app id",
            "LARK_APP_SECRET": "your app secret"
        }
    }
}

Available Tools

1. set_user_access_token

   • Purpose: Set user access token for accessing private documents
   • Args: token (string) - The user access token, according to lark setting, the user_access_token will expire in two hours.
   • Returns: Confirmation message

2. get_lark_doc_content

   • Purpose: Retrieve document content from Lark
   • Args: documentUrl (string) - The URL of the Lark document
   • Returns: Document content in text format
   • Supports:
     • Doc URLs: https://xxx.feishu.cn/docx/xxxxx
     • Wiki URLs: https://xxx.feishu.cn/wiki/xxxxx

3. search_wiki

   • Purpose: Search documents in Lark Wiki
   • Args:
     • query (string) - Search keywords
     • page_size (int, optional) - Number of results to return (default: 10)
   • Returns: JSON string containing search results with following fields:
     • title: Document title
     • url: Document URL
     • create_time: Document creation time
     • update_time: Document last update time

Error Messages

Common error messages and their solutions:

• "Lark client not properly initialized": Check your LARK_APP_ID and LARK_APP_SECRET
• "Invalid Lark document URL format": Verify the document URL format
• "Failed to get document content": Check document permissions and token validity
• "Failed to get app access token": Check your application credentials and network connection
• "Failed to get wiki document real ID": Check if the wiki document exists and you have proper permissions
• "Document content is empty": The document might be empty or you might not have access to its content

License

MIT License