Skip to main content
Glama

Grammar Police MCP Server ๐Ÿ‘ฎโ€โ™‚๏ธโœ๏ธ

An MCP (Model Context Protocol) server that provides automated grammar checking capabilities to MCP-compatible clients like Claude Desktop and Claude Code.

๐Ÿ“– How It Works

This server exposes a check_grammar tool. The workflow is designed as a "middleware" style interception:

  1. You configure Claude to send your raw input to this tool first.

  2. The tool returns your text along with correction instructions.

  3. Claude (the LLM) performs the actual correction based on the tool's output before answering your technical question.

This design keeps the server lightweight while leveraging the LLM's full language understanding capabilities.

Related MCP server: Grammar Fix AI MCP

โœ… Prerequisites

๐Ÿ“ฆ Installation

No manual download required. You can run it directly via npx.

npm install -g grammar-police-mcp

Option 2: Clone from GitHub (For Development)

# Clone the repository
git clone [https://github.com/acforu/grammar-police-mcp.git](https://github.com/acforu/grammar-police-mcp.git)
cd grammar-police-mcp

# Install dependencies
npm install

# Build the project
npm run build

โš™๏ธ Configuration

โš ๏ธ Important: Claude Desktop (GUI) and Claude Code (CLI) use different config files. Please follow the section matching your tool.

๐Ÿ–ฅ๏ธ For Claude Desktop (GUI)

Config File Location:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Add grammar-police to the mcpServers object.

If using npm (Option 1):

macOS:

{
  "mcpServers": {
    "grammar-police": {
      "command": "npx",
      "args": ["-y", "grammar-police-mcp"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "grammar-police": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "grammar-police-mcp"]
    }
  }
}

(Note: On Windows, cmd /c is required to invoke npx correctly.)

If using Source Code (Option 2):

macOS:

{
  "mcpServers": {
    "grammar-police": {
      "command": "node",
      "args": ["/absolute/path/to/grammar-police-mcp/build/index.js"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "grammar-police": {
      "command": "node",
      "args": ["C:\\absolute\\path\\to\\grammar-police-mcp\\build\\index.js"]
    }
  }
}

(Note: Replace paths with your actual project location. Ensure your build output folder is build.)


โŒจ๏ธ For Claude Code (CLI)

Config File Location:

  • Windows: %USERPROFILE%\.claude.json

  • macOS/Linux: ~/.claude.json

  • *Or configure per-project in your project's .claude.json*

Add the server configuration using the same JSON format as the Desktop version above.

๐Ÿš€ Usage

Since this tool is passive (it doesn't fix things unless you ask it to), you must instruct Claude to use it on every message.

Method A: Claude Desktop (Project Instructions)

  1. Open your Project in Claude.

  2. Click Project Settings (or Edit).

  3. Add the following to Project Instructions (System Prompt):

GLOBAL INSTRUCTION: You have access to a tool named grammar-police. For every user message, you MUST first run the check_grammar tool on the raw input to check for errors. Display the corrections if any, then proceed to answer the user's request.

Method B: Claude Code (CLAUDE.md)

Create or edit the CLAUDE.md file in your project root:

## Tool Usage
You have access to a tool named `grammar-police`. Call the `check_grammar` tool with the user's raw input to check for English grammar errors before generating your response.

Verify It Works

Restart Claude. Type a message with intentional errors:

"i write code good."

Claude should call the tool and respond with a correction before answering.

๐Ÿ› ๏ธ Development

  • npm run build: Compile TypeScript to JavaScript (outputs to /build)

  • npm start: Run the compiled server

  • npm run dev: Watch mode for development

๐Ÿ“„ License

MIT

Available Tools

1 tool
check_grammarA

Check and correct English grammar in the provided text. Returns corrections in a structured format.

When you receive the text, analyze it for grammar errors and respond with:

  • "original" -> "corrected" for each error found

  • Corrected: "full corrected sentence"

  • If no errors: "No grammar issues."

IGNORE: Capitalization, punctuation, technical terms/variable names, error/warning logs.

Inputs: text (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelogโ€ฆ

    TDQS

    A4.4/5.0

    Scored across 1 tool

    Disambiguation5/5

    There is only one tool, so there are no overlapping purposes to confuse. An agent can unambiguously select check_grammar for any grammar-related request.

    Naming Consistency5/5

    The single tool name 'check_grammar' follows a clean verb_noun convention and accurately reflects its function. With only one tool, there are no inconsistent naming patterns to weigh against it.

    Tool Count3/5

    A single tool is minimal and, by the rubric, feels thin for a server-level surface. However, grammar checking is a narrow domain, so the count is borderline rather than an extreme mismatch.

    Completeness5/5

    The tool covers both detection and correction of grammar errors and returns a structured result, including an explicit no-errors case. No obvious operations are missing for the stated grammar-checking purpose.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      B
      maintenance
      Offline spell check and BYOK grammar checking for AI assistants. 100% offline spell check via nspell (zero tokens, zero API calls). BYOK grammar checking with your own Gemini, OpenAI, or Claude API key. Works with Claude Desktop, Cursor, ChatGPT, and any MCP-compatible tool. 8 languages supported.
      -
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that gives Claude AI the ability to read, analyze, modify, and debug ANTLR4 grammars, enabling grammar debugging and manipulation for Claude Desktop.
      55
      1
      MIT