cowriter

Cowriter

Cowriter is an MCP server for collaborative writing within your LLM chat.

Installation

Note: all commands should be run from the root of the repository, i.e. "cowriter/". DO NOT run them from "cowriter/cowriter".

Installing the python dependencies

Make sure uv is installed.

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

Install the dependencies.

uv sync

Configuring Claude Desktop

Configure Claude Desktop to use the Cowriter MCP server.

uv run cowriter-install

If the above fails, update this file:

~/Library/Application\ Support/Claude/claude_desktop_config.json

with the following content:

{
    "mcpServers": {
        "cowriter": {
            "command": "uv",
            "args": [
                "--directory", 
                "PATH/TO/THIS/REPO",
                "run", 
                "cowriter/server.py"
            ]
        }
    }
}

Restart Claude Desktop.

Setup Telegram

Refer to the telegram docs to get your API ID and hash. Then run

uv run setup-telegram

and enter your API ID and hash.

You will be prompted to enter your phone number, and telegram will send you a verification code that you will have to enter to verify this application.

Updating

To update when a new version is released, run

git pull
uv sync
uv run cowriter-install

to make sure all dependencies are updated.

Usage

Sending a message

To send a message, simply inform Claude of the message and the telegram username of the recipient. For example, something like

Please send "Hello, world!" to @shawntcy72

Claude will then send a message to the specified user.

Testing

Telegram

To test the telegram functionality, run

uv run send-telegram-message

and follow the prompts to send a message to the specified username.