home / mcp / appflowy mcp server

AppFlowy MCP Server

Uploads generated content to AppFlowy using a local Python script via an MCP client.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "18896101294-my-appflowy-mcp": {
      "command": "uv",
      "args": [
        "run",
        "/path/to/your/my-appflowy-mcp/appflowy_skill.py"
      ],
      "env": {
        "APPFLOWY_EMAIL": "[email protected]",
        "APPFLOWY_PASSWORD": "your-password",
        "APPFLOWY_WORKSPACE_ID": "your-workspace-id",
        "APPFLOWY_PARENT_VIEW_ID": "your-parent-view-id"
      }
    }
  }
}

This MCP Server automates uploading generated rich text to AppFlowy. It runs locally and uses environment-managed tooling to execute a Python script that sends content to your AppFlowy workspace, making it easy to publish notes and documents directly from Claude-like workflows.

How to use

You will connect Claude Code or another MCP client to this server so that any content you generate can be sent to AppFlowy with a simple command. Ensure your AppFlowy workspace and parent view are configured, and that you have the workspace credentials available. When you issue a content command from the MCP client, the server will run the script to upload the content as a document in AppFlowy.

How to install

Prerequisites you need before installing the MCP server.

Install uv for environment management on macOS or Linux, or on Windows via PowerShell.
Python 3.12 or newer is required.
Have AppFlowy credentials ready (email, password) and workspace identifiers (Workspace ID and Parent View ID).

Step-by-step commands to set up the MCP server locally.

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows PowerShell
irm https://astral.sh/uv/install.ps1 | iex

# Install Python 3.12+ is assumed to be installed separately

# Clone the project (example path used for illustration)
git clone https://github.com/18896101294/my-appflowy-mcp.git
cd my-appflowy-mcp

# Install dependencies via uv
uv sync

# Verify installation
uv pip list

Additional setup and running

Configure AppFlowy credentials and IDs in the environment, then ensure the absolute path to the script is known for your system.

Configuration and usage notes

The MCP server is designed to run a Python script that uploads content to AppFlowy. You will specify how to launch the script with the appropriate environment variables so content can be sent to the correct workspace and view.

Troubleshooting

If you encounter issues, check that Python 3.12+ is active, the virtual environment is correctly created, and the AppFlowy credentials (email, password) plus Workspace ID and Parent View ID are valid. If the upload fails, verify network access to AppFlowy and permissions for the target workspace.

Examples and usage notes

Typical use cases include converting a markdown content block into an AppFlowy document with a defined title, or uploading a generated analysis report to a project page. You can issue commands to trigger the upload and have the content appear under your specified AppFlowy workspace.

Security considerations

Store credentials securely. Use environment variables to keep sensitive values out of command history and project files. Regularly rotate credentials and limit workspace permissions to what is strictly needed for uploads.

Tips for maintenance

Keep uv and Python dependencies up to date. Re-run the synchronization step if you modify the dependency set, and validate that the AppFlowy upload script continues to work after updates.

Available tools

uv

Environment and dependency management tool used to set up and run the MCP server and its Python dependencies.

mcp list

Command used to verify MCP server status within Claude Code or the MCP client.