# Idiolect AI [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/Moshpit-Labs/idiolect-mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 1272  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/idiolect-ai-2

## Description
Loads your personal writing voice into any AI and scores how closely a draft matches it.

## Tools
Capabilities this server exposes over MCP:

- **write** — Drafts an email, message, post, reply, doc, or report in the user's style. Use for new writing for or on behalf of the user, using their current Writing Profile when available. It writes from their request, facts, notes, or an outline, without inventing missing facts. The tool produces the draft. There is no need to draft it first. Works without a Writing Profile. Put the user's directions in `instructions`. It returns finished writing for direct presentation. When presenting the writing, preserve its wording.
- **rewrite** — Rewrites text: 'make this sound like me', 'less AI', shorter, or clearer. Use for writing for or on behalf of the user, including drafts the host wrote for them. It rewrites in the user's style using their current Writing Profile when available. It covers an email, message, post, reply, or doc, from a grammar fix to a complete rewrite. Covers asks such as 'make this less AI-written' or 'make it less formal'. Changes include grammar, spelling, clarity, length, structure, tone, style, audience, or format. It can summarize, expand, simplify, paraphrase, or repurpose. Works without a Writing Profile. Unless the user asks to change them, it keeps supplied facts and protected wording. Put the user's change request in `instructions`. It returns finished writing for direct presentation. When presenting the writing, preserve its wording.
- **refine_writing** — Changes writing Idiolect AI returned, such as 'make it shorter and warmer'. The user does not need to name Idiolect AI again. It covers follow-ups on writing from `write`, `rewrite`, or `refine_writing`. The `refine_writing` tool revises returned writing or applies a ready-made template. Send the latest `writingJobVersionId`, or `outputReference` when no version was returned, but not both. Send `change` or `templateId` for a new version. If the change sets a new form, language or fact of the situation, send it in `format`, `language` or `situation`. Older hosts may still send `outcome`, `finalText` or `comment` here. Record reactions with `record_writing_feedback`.
- **record_writing_feedback** — Use this when the user reacts to writing Idiolect AI returned, or you observe what happened to it. It records an outcome, final wording or comment. Feedback can update the user's Writing Profile. Send only what you know; `outcome` is optional. To change the writing, use `refine_writing`.
- **view_writing_profile** — Shows the user's current Writing Profile and rules, and lists their Writing Profiles. To view another Writing Profile, set `profile` to its id or name. To list its writing samples, set `samples` true. Writing Profiles update continuously as the user writes, so read the current one here each time instead of keeping a saved copy.
- **manage_profile** — Change the user's Writing Profiles and default writing template. Choose an `action`: `create_profile`, `add_samples`, `remove_sample`, `add_rule`, `remove_rule`, `rename_profile`, `set_current_profile`, or `set_default_template`. When the user shares writing they authored in this conversation, save it with `add_samples`. Without a Writing Profile, use `create_profile`. When the user states a lasting writing preference, save it with `add_rule`. Keep stated rules in the user's words and preserve their scope. Do not save inferred patterns as stated rules. Reuse that permission for the rest of this conversation without asking again. The user can delete a whole Writing Profile on the Idiolect AI website.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "idiolect-ai": {
    "command": "npx",
    "args": ["-y","idiolect-mcp"],
    "env": {
      "IDIOLECT_API_KEY": "",
      "IDIOLECT_SLUG": "",
      "IDIOLECT_BASE": ""
    }
  }
}
```

**Requires environment variables:** `IDIOLECT_API_KEY`, `IDIOLECT_SLUG`, `IDIOLECT_BASE` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What Idiolect AI MCP server does

Idiolect AI MCP server gives an MCP-compatible AI access to a personal writing voice represented by an Idiolect AI Voice Card or Voice Profile. The available tools cover five operations: retrieving voice guidance, creating a private profile from approved writing, measuring how closely text matches a voice, rewriting existing prose, and generating a draft from a brief.

The server supports two local configuration patterns. Account mode uses an Idiolect API key and resolves the user’s Voice Profile through the account. Slug mode uses a voice slug obtained from an Idiolect result URL. Slug mode supports voice retrieval and stateless scoring with locally configured samples, while profile creation, rewriting, and drafting are account-mode tools.

## How it works

For the hosted option, an MCP client connects to `https://idiolect.app/api/mcp` using Streamable HTTP and OAuth 2.1. The repository also provides a stdio server that clients can launch with `npx -y idiolect-mcp`; this option is intended for clients without remote MCP support or for users who want to run the process themselves.

`get_my_voice` returns the Voice Card for use during generation. If an account does not yet have a Voice Profile, setup can remain in the conversation: the user can provide three to five writing examples or complete the short guided interview. Profile creation occurs only after the user explicitly requests it from supplied or approved evidence.

`create_my_voice` sends approved writing to the Idiolect AI account as private Voice Profile evidence and does not return that evidence through the tool. Retries can use an idempotency key. In slug mode, configured samples are used only for stateless scoring and are not stored.

## Setup and configuration

Account mode requires `IDIOLECT_API_KEY`. A typical stdio configuration launches the package with `npx` and passes the key through the server environment. Slug mode instead uses `IDIOLECT_SLUG`; the slug is the value in an Idiolect URL such as `idiolect.app/v/<slug>`. The `slug` may also be supplied to `get_my_voice` per call.

Set `IDIOLECT_BASE` when the server should use a self-hosted instance rather than the default `https://idiolect.app`. The repository includes a Docker image for starting and inspecting the stdio server. Docker must be run interactively with `-i`; the transport is not a network port.

## Tools and capabilities

- `get_my_voice`: returns the configured Voice Card.
- `create_my_voice`: creates an account-based private Voice Profile from approved writing.
- `score_voice`: evaluates text against the configured voice; account mode uses the API key, while slug mode uses local samples.
- `rewrite_in_voice`: rewrites drafted prose in the account’s voice.
- `draft_in_voice`: creates prose from a brief in the account’s voice.

## Limitations and notes

The account-only operations are `create_my_voice`, `rewrite_in_voice`, and `draft_in_voice`. The stdio process needs either an API key or a slug for the tools that require voice data. Docker is supplied mainly as a reference image for startup and tool introspection; `tools/list` works without credentials, but the tools themselves require a key or slug. The project is MIT licensed.

_Full upstream README: https://allmcps.com/mcp/idiolect-ai-2/readme_