What is Mcp Inked

mcp-inked is a powerful drafting tool designed for novelists, report writers, and anyone involved in long-form content creation. It leverages Claude’s assistance to help users draft, revise, and finalize their written works efficiently.

Use cases

Use cases for mcp-inked include drafting novels, writing research reports, compiling business documents, and organizing content for blogs or articles, allowing for iterative refinement and easy content generation.

How to use

To use mcp-inked, users can interact with Claude through natural language commands to create drafts, manage chapters, and generate content in various formats. Installation involves cloning the repository, installing dependencies, and configuring the database settings.

Key features

Key features of mcp-inked include draft management with automatic versioning, persistent storage in PostgreSQL or SQLite, chapter-based organization for long documents, and support for multiple output formats such as Markdown, plain text, Microsoft Word, and Apple Pages.

Where to use

mcp-inked can be used in various fields including literature, academic writing, business reporting, and any domain that requires the creation of extensive written content.

Inked

A powerful MCP server for memory management with Claude apps. Fast, simple, and optionally enhanced with AI-powered search.

Features

• Fast text search - Lightning-fast memory retrieval by default
• AI-powered search - Optional embedding-based semantic search
• AI reranking - Experimental reranking for even better results
• Simple storage - Plain text storage in SQLite (no encryption overhead)
• Secure - All data stored locally in ~/.inked/

Installation

Option 1: (Recommended)

npm install -g @frgmt/inked

Option 2: Local Development

git clone https://github.com/frgmt/inked.git
cd inked
npm install
npm run build
node dist/index.js

Basic Usage

Add to your MCP server configuration:

Standard (fast text search):

{
  "mcpServers": {
    "inked": {
      "command": "npx",
      "args": [
        "@frgmt/inked"
      ]
    }
  }
}

With AI embeddings (semantic search):

{
  "mcpServers": {
    "inked": {
      "command": "npx",
      "args": [
        "@frgmt/inked",
        "--use-embeddings"
      ]
    }
  }
}

With embeddings + AI reranking (best results):

{
  "mcpServers": {
    "inked": {
      "command": "npx",
      "args": [
        "@frgmt/inked",
        "--use-embeddings",
        "--use-reranking"
      ]
    }
  }
}

Experimental Features

AI-Powered Search (Optional)

Inked supports experimental embedding-based search for more nuanced memory retrieval.

Embedding Models

Reranking Models (Requires embeddings)

How to Choose Models

For most users: Start with no flags (fast text search)

For better semantic understanding: Add --use-embeddings

• Good for finding memories by meaning rather than exact words
• First run downloads ~2GB model (one-time)

For nuanced, longer memories: Use --use-embeddings=4b

• Better at understanding context in longer text
• Handles more complex relationships between ideas

For best results: Add --use-reranking with embeddings

• AI re-scores top candidates for optimal ranking
• Significantly improves search quality

For power users: --use-embeddings=8b --use-reranking=4b

• Best possible search quality
• Requires 20+ GB RAM
• Good for research, documentation, complex projects

Memory Requirements

Models are cached locally and only downloaded once

Usage Guide

Auto-Memory Setup

Add this to your Claude settings/preferences:

“At the start of new conversations, use the inked Read tool with ‘ALL’ to load my memories. Only mention memories when directly relevant to our conversation. Use the Write tool to save important preferences, facts, or insights that should be remembered for future conversations.”

How It Works

• Read once per conversation: Memories stay in context after initial load
• Silent operation: Claude uses memories without mentioning them unless relevant
• Smart writing: Automatically saves important information for future sessions

When to Write Memories

• User preferences and communication style
• Important project information and context
• Recurring topics or themes
• Facts that should persist across conversations
• Insights or patterns worth remembering

Search Strategies

Text Search (default):

• Fast LIKE-based matching
• Good for exact terms and phrases
• Use "ALL" to see everything

Embedding Search:

• Semantic understanding
• Finds related concepts even with different words
• Better for complex queries

Embedding + Reranking:

• Highest quality results
• AI-powered relevance scoring
• Best for finding the most relevant memories

Tools

read

Search and retrieve memories.

Parameters:

• search (required): Query string or “ALL” for everything
• topr (optional): Number of results (1-5, default: 3)

write

Add or delete memories.

Parameters:

• content (required): Memory text (NEW) or search query (DELETE)
• sTool (required): “NEW” or “DELETE”
• id (optional): Specific ID to delete

License

AGPL v3 - Open source for personal use. Commercial use requires either open-sourcing your application or a commercial license.