What is Autowriter Mcp

Autowriter-mcp is a token-saving Model Context Protocol (MCP) server designed to coordinate automated writing workflows between Obsidian vaults and LMStudio, enabling efficient AI-powered content generation while minimizing token usage.

Use cases

Use cases include automated generation of book sections, efficient batch content creation for articles or reports, managing writing tasks through a queue system, and maintaining updated links in Obsidian index files.

How to use

To use autowriter-mcp, install it via pip or uvx, configure your Obsidian vault path, and run the server. Ensure that LMStudio and Claude Desktop are set up properly for seamless integration.

Key features

Key features include token-saving architecture that reduces Claude token usage by 80-90%, direct integration with Obsidian, automated book writing capabilities, batch content generation, queue management for writing tasks, and automatic index link management.

Where to use

Autowriter-mcp is ideal for writers, authors, and content creators who utilize Obsidian for note-taking and want to enhance their writing process with AI assistance, particularly in book writing and content generation.

Autowriter MCP Server

A token-saving Model Context Protocol (MCP) server that coordinates automated writing workflows between Obsidian vaults and LMStudio. This server enables AI-powered content generation while dramatically reducing Claude token usage by generating content locally via LMStudio and saving directly to Obsidian vaults.

🚀 Key Features

• Token-Saving Architecture: Save 80-90% of Claude tokens by generating content locally via LMStudio
• Direct Obsidian Integration: Seamlessly integrates with Obsidian vaults and markdown files
• Automated Book Writing: Analyze book structure and generate missing sections automatically
• Batch Content Generation: Generate multiple sections efficiently in one operation
• Queue Management: Queue writing tasks and process them automatically
• Index Link Management: Automatically update Obsidian index files with generated content links

🛠 Prerequisites

• Python 3.11+: Required for running the MCP server
• LMStudio: Running locally on http://localhost:1234 (or configurable URL)
• Claude Desktop: With MCP support for connecting to the server
• Obsidian: For managing your writing vault (optional but recommended)

📦 Installation

Method 1: Using uvx (Recommended)

# Install and run directly with uvx
uvx autowriter-mcp '/path/to/your/obsidian/vault'

Method 2: Using pip

# Install from PyPI
pip install autowriter-mcp

# Run the server
autowriter-mcp '/path/to/your/obsidian/vault'

Method 3: Local Development

# Clone the repository
git clone https://github.com/infinitimeless/autowriter-mcp.git
cd autowriter-mcp

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -e .

# Run the server
autowriter-mcp '/path/to/your/obsidian/vault'

⚙️ Configuration

Command Line Options

autowriter-mcp [vault_path] [options]

Arguments:
  vault_path              Path to your Obsidian vault directory (required)

Options:
  --index-file FILENAME   Index file name (default: book_index.md)
  --lmstudio-url URL      LMStudio server URL (default: http://localhost:1234)
  --version               Show version information
  --help                  Show help message

Claude Desktop Configuration

Add to your Claude Desktop MCP configuration:

For uvx installation:

{
  "mcpServers": {
    "autowriter-mcp": {
      "command": "uvx",
      "args": [
        "autowriter-mcp",
        "/path/to/your/obsidian/vault"
      ]
    }
  }
}

For local development:

{
  "mcpServers": {
    "autowriter-mcp": {
      "command": "/path/to/autowriter-mcp/.venv/bin/python",
      "args": [
        "-m",
        "autowriter_mcp.server",
        "/path/to/your/obsidian/vault"
      ]
    }
  }
}

🎯 Usage

1. Prepare Your Obsidian Vault

Create an index file (default: book_index.md) in your vault with your book structure:

# My Book Title

## Chapter 1: Introduction
## Chapter 2: Getting Started
## Chapter 3: Advanced Topics
## Chapter 4: Conclusion

2. Available MCP Tools

analyze_book_structure

Analyze your vault structure and identify missing content sections.

generate_and_save_section

🚀 Token-Saving: Generate content locally via LMStudio and save directly to vault.

batch_generate_sections

🚀 Ultra Token-Saving: Generate multiple sections in one operation.

process_writing_queue

🚀 Auto Token-Saving: Process entire writing queue automatically.

request_content_generation

Add content generation requests to the queue for later processing.

update_index_links

Update your index file with Obsidian links to newly created content.

get_writing_status

Get current progress and queue status.

🏗 Architecture

Token-Saving Design

The server is specifically designed to minimize Claude token usage:

1. Local Generation: Content is generated by LMStudio, not Claude
2. Direct File Writing: Content is saved directly to vault files
3. Metadata Only: Claude only receives generation metadata, not content
4. Batch Processing: Multiple sections can be generated in one operation

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built on the Model Context Protocol
• Integrates with LMStudio for local AI generation
• Designed for Obsidian vault management
• Compatible with Claude Desktop MCP support

🚀 Save Claude tokens while accelerating your writing workflow with autowriter-mcp!