writefreely

This MCP server provides programmatic access to WriteFreely instances, enabling AI agents to publish and manage content, browse feeds, and handle collections. It supports both WriteFreely instances hosted on Write.as and self-hosted WriteFreely deployments. After installing uv/uvx, configure the MCP client to point to this server so agents can authenticate and perform actions such as publishing posts, editing them, deleting content, and browsing public or private feeds. The available tools expose a set of operations for authentication, publishing, editing, deleting, and retrieving posts, as well as listing and browsing collections and feeds. Use the client with your WriteFreely base URL and a valid access token to ensure actions are authenticated where required. The server is designed to work with WriteFreely and Write.as ecosystems, enabling automation workflows for content publishing and management.

Prerequisites:

• Python environment with uv/uvx support (uvx recommended).
• Access to a WriteFreely instance and a valid access token.

Installation options:

Option 1: Using uv/uvx (recommended)

1. Install uv or uvx (example using uvx):

uvx --version

2. Install the MCP server package (as per uvx usage):

uvx --from writefreely-mcp-server writefreely-mcp

3. Ensure environment variables are set for your target WriteFreely instance:

export WRITEFREELY_BASE_URL="https://write.as"  # or your self-hosted URL
export WRITEFREELY_ACCESS_TOKEN="your_token_here"

4. Run the MCP client using the configuration provided in the mcp_config section.

uvx --from writefreely-mcp-server writefreely-mcp

Option 2: Using uv (legacy)

1. Install uv if you haven't:

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

2. Install the MCP server via uv tool installation (as shown in the README):

uv tool install writefreely-mcp-server
writefreely-mcp

3. Set required environment variables as shown above and run the MCP client.

export WRITEFREELY_BASE_URL="https://write.as"
export WRITEFREELY_ACCESS_TOKEN="your_token_here"

Option 3: Using pip (Python environment)

1. Install uv (as a wrapper) and the MCP client if distributed that way, or follow uv/uvx instructions above.
2. Configure and run as described.

Prerequisites recap:

• A Python/uv environment or uvx setup
• Access token for WriteFreely
• Base URL for your WriteFreely instance

Tips and notes:

• The MCP client configuration requires WRITEFREELY_BASE_URL and WRITEFREELY_ACCESS_TOKEN to be set for authenticated operations; omit or leave placeholder values only for read-only tasks.
• If your WriteFreely instance is self-hosted, set WRITEFREELY_BASE_URL to the appropriate URL (including http/https).
• Ensure the access token has the necessary permissions for publishing and editing content.
• The Available Tools list in the README includes login, publish_post, edit_post, delete_post, read_post, list_my_posts, list_my_collections, browse_collection, and browse_public_feed. These map to API interactions with WriteFreely via the MCP server.
• Networking: Ensure the MCP client can reach the WriteFreely instance (consider firewall rules and CORS where applicable).
• If you update base URL or tokens, restart the MCP client to apply changes.
• For debugging, test with read-only actions (e.g., browse_public_feed or read_post) before attempting publish or edit operations.