textforge

TextForge for Claude Code

Official Claude Code plugin for TextForge — personal email automation with AI drafting and human approval.

Start free trial → — 7 days free. Card on file, no charge until trial ends.

---

What This Does

You write the same emails every week. Follow-ups, vendor onboarding, client check-ins. TextForge lets Claude draft them for you — reading your threads, pulling context from your CRM or files, and composing the message. You review and approve before anything sends from your Gmail.

This plugin connects Claude Code to the TextForge MCP server. It includes 22 MCP tools and bundled skills for writing effective, human-sounding emails.

Nothing sends without your approval. Claude can draft, read, search, and manage attachments — but every email waits in your TextForge queue until you hit approve.

---

Installation

Option A — OAuth (No Token Required)

The fastest way to connect. Claude Code handles authentication automatically:

claude mcp add textforge --transport http https://textforge.net/mcp

Claude Code will open your browser to sign in and grant access. If you're new to TextForge, you'll be walked through account creation and setup before the connection completes — the full onboarding takes 5-15 minutes for new users, under 60 seconds for existing users.

Once authorized, your connection appears in Settings → API Tokens as "MCP - Claude Code". You can revoke it there at any time.

Option B — API Key (Plugin Marketplace)

Good for CI/headless environments or if you prefer explicit token management:

1. Sign up at textforge.net and generate a token at textforge.net/tokens
2. Set the environment variable in your shell config (.bashrc, .zshrc, etc.):

   export TEXTFORGE_API_KEY="your-token-here"
   

3. Add the plugin marketplace:

   /plugin marketplace add textforge-app/textforge-claude-plugin
   

4. Install the plugin:

   /plugin install textforge@textforge
   

---

Available Tools (22)

Draft Management

Tool	What It Does
create_draft	Create an email draft and submit for approval
list_drafts	List drafts with optional status/recipient filtering
get_draft	Get draft details including status and approval history
update_draft	Update an existing draft's content or recipients
submit_draft	Submit a draft for approval (auto-submitted on create)
get_draft_activity	View complete draft activity log
reject_draft	Reject a pending draft
delete_draft	Delete a draft (only non-pending statuses)

Thread Management

Tool	What It Does
list_threads	List recent email threads
list_engaged_threads	List threads where you've sent messages
get_thread	Read full thread with messages
get_thread_by_external_id	Look up thread by provider's thread ID
sync_thread	Sync a specific thread for latest messages
sync_inbox	Trigger full inbox sync
search_messages	Search with Gmail-style query syntax
search_threads_by_contact	Find threads by contact email
import_thread	Import a thread from email provider

Attachment Management

Tool	What It Does
list_message_attachments	List attachments on a received message
get_attachment_download_url	Get presigned download URL for an attachment
list_draft_attachments	List attachments on a draft
get_draft_attachment_upload_url	Get presigned upload URL to attach a file
remove_draft_attachment	Remove an attachment from a draft

---

Bundled Skills

This plugin includes two skills beyond the core TextForge connector:

Email Writing Guide

Best practices for composing effective, human-sounding emails. Includes:

• 6 core writing principles (be direct, use specific language, frame questions clearly)
• Technical formatting rules (HTML line breaks, no em dashes, no signatures)
• A mandatory AI pattern audit — 12 common LLM writing tells to catch before sending
• Follow-up timing framework
• Anti-pattern reference table
• Pre-send checklist

TextForge (Core)

Full 22-tool reference with parameter documentation, attachment workflow, and draft lifecycle management.

---

Example Usage

Once installed, try asking Claude:

"Go through my Pipedrive deals and draft follow-ups for anything that's been quiet for 2 weeks"

"Draft a reply to the thread with [email protected] — she asked for the Q1 proposal status"

"Search my inbox for the vendor security questionnaire and draft a response using our existing data"