# SpeakSwiftlyServer

> Easy, Local TTS for macOS | Custom Voices & Text Processing. Codex Plugin via Socket Marketplace. LAN w/ Bonjour.

- **Type:** MCP server
- **Install:** `agentstack add mcp-gaelic-ghost-speakswiftlyserver`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [gaelic-ghost](https://agentstack.voostack.com/s/gaelic-ghost)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [gaelic-ghost](https://github.com/gaelic-ghost)
- **Source:** https://github.com/gaelic-ghost/SpeakSwiftlyServer

## Install

```sh
agentstack add mcp-gaelic-ghost-speakswiftlyserver
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# SpeakSwiftlyServer

*A local speech platform for Apple systems and developer workflows.*

Listen to the short Speak Swiftly Codex plugin promo:

  Download the Speak Swiftly Codex plugin promo audio.

## Table of Contents

- [Overview](#overview)
- [Quick Start](#quick-start)
- [Usage](#usage)
- [Development](#development)
- [Repo Structure](#repo-structure)
- [Release Notes](#release-notes)
- [License](#license)

## Overview

### Status

`SpeakSwiftlyServer` is actively maintained and supported by Gale.

### What This Project Is

SpeakSwiftlyServer (*Speak Swiftly*) is a high-quality, local-first speech runtime built for macOS. Custom voices, batch jobs, easy integrations, and more.

### Motivation

This project was borne of my own need for affordable, customizable, high-quality text-to-speech, with easy integration into the apps I already used. I'm quite proud of this one already, and tbh we're just getting started~

## Quick Start

Add or upgrade the Socket marketplace entry to your Codex. Then, restart Codex and enable `Speak Swiftly` in the Plugin Directory under Socket.

Add Socket:
```bash
codex plugin marketplace add gaelic-ghost/socket
```

Upgrade Socket and Enabled Plugins:
```bash
codex plugin marketplace upgrade socket
```

After the plugin is enabled, install or refresh the local speech service:

```bash
xcrun swift run SpeakSwiftlyServerTool launch-agent install
xcrun swift run SpeakSwiftlyServerTool healthcheck
```

If using Codex Hooks, review and trust the stop hook from Speak Swiftly to have all replies automatically spoken in the order they arrive.

The plugin and the local service are separate on purpose. The plugin gives Codex the skills, MCP connection, and speech hooks. The local service is the native Swift process that actually speaks.

## Usage

Once the service is healthy, agents can use `Speak Swiftly` to:

- speak "final assistant replies" through `Speak Swiftly`
- queue speech, create new voice profiles, adjust how words are spoken, and control playback
- inspect the runtime, voice profiles, text profiles, and recent requests
- set default voice and model preferences

Operators can also open the local control panel at `http://127.0.0.1:7338/control-panel/` when running the foreground tool, or at the configured local HTTP listener port for an installed service.

The normal end-user path is plugin-managed. Do not copy repo-local hook files into a Codex home directory for ordinary setup.

For the detailed HTTP and MCP contract, see [API.md](./API.md).

## Development

For local setup, validation, contribution workflow, release workflow, LaunchAgent details, embedding notes, plugin-maintainer guidance, and repo-specific maintainer rules, see [CONTRIBUTING.md](./CONTRIBUTING.md) and [AGENTS.md](./AGENTS.md).

## Repo Structure

```text
.
├── Sources/
├── Tests/
├── docs/
├── hooks/
├── skills/
├── .codex-plugin/
├── API.md
├── CONTRIBUTING.md
└── Package.swift
```

## Release Notes

Tagged release notes live in [GitHub Releases](https://github.com/gaelic-ghost/SpeakSwiftlyServer/releases). Historical release notes and checklists live under [docs/releases](./docs/releases/).

## License

See [LICENSE](./LICENSE).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [gaelic-ghost](https://github.com/gaelic-ghost)
- **Source:** [gaelic-ghost/SpeakSwiftlyServer](https://github.com/gaelic-ghost/SpeakSwiftlyServer)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-gaelic-ghost-speakswiftlyserver
- Seller: https://agentstack.voostack.com/s/gaelic-ghost
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.