Skip to main content
Glama
README.md
# Textwell Write Tool (MCP Server)

A specialized MCP server designed exclusively for writing text to the Textwell application on macOS.

## Overview

This tool provides a straightforward way to write text to Textwell. 

## Features

The server provides a single tool: `write-text`

### Write Text Tool

Writes text to Textwell using specified modes:

- **Replace Mode** (default)
  - Replaces the entire content with new text
  - Use case: Complete content replacement

- **Insert Mode**
  - Inserts text at the current cursor position
  - Use case: Adding content within existing text

- **Add Mode**
  - Appends text to the end of current content
  - Use case: Adding new content while preserving existing text

## Limitations

- Write-only operations (no read capabilities)

## Development Setup

### Prerequisites

- Node.js v22.12.0 (managed by Volta)
- npm v10.9.0 (managed by Volta)
- macOS (for Textwell integration)

### Installation

1. Clone the repository
```bash
git clone [repository-url]
cd textwell-mcp
```

2. Install dependencies
```bash
npm install
```

3. Build the server
```bash
npm run build
```

## License

MIT

TDQS

B3/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of confusion or overlap between tools. The single tool 'write-text' has a clear and distinct purpose that cannot be misselected against other tools.

Naming Consistency5/5

The single tool name 'write-text' follows a consistent verb-noun pattern. Since there is only one tool, there is no inconsistency in naming conventions to evaluate.

Tool Count2/5

A single tool is generally too few for a server's purpose, as it limits functionality and suggests an incomplete or trivial scope. For a text-related server, one tool is insufficient for comprehensive operations.

Completeness1/5

The tool surface is severely incomplete for a text application server. With only a write operation, there are obvious gaps such as reading, editing, deleting, or managing text, which will cause agent failures in typical workflows.

Maintenance

ActivityInactive
ResponsivenessNo issues