Grammarly MCP server Let your AI agent check and tidy your Grammarly drafts.

ToolWhat it doesAccess

• list_documents Documents on your Grammarly dashboard, or in Trash. read

  Lists the documents saved in your Grammarly Editor at app.grammarly.com, in the order the dashboard shows them. Each item has an id, a title and the time of the last edit. With status trash it lists Trash instead, where Grammarly keeps deleted documents for 30 days. Use document_id in the other tools.

  MCP callgrammarly_read → list_documents

  REST endpointGET https://cotlet.dev/api/v1/grammarly/documents

  Parameters

  Parameters: list_documents

  Name	Type	Description
  status string	string	active for the dashboard or trash for Trash. Default: active.
  cursor string	string	next_cursor from the previous page.

  Example response

  {
    "documents": [
      {
        "document_id": "doc_7c21a9",
        "title": "Launch announcement",
        "updated_at": "2026-11-04T15:12:00Z"
      },
      {
        "document_id": "doc_52fe08",
        "title": "Customer case study",
        "updated_at": "2026-10-29T09:40:00Z"
      }
    ],
    "next_cursor": null
  }

• get_document Title and text of one document. read

  Returns the title and the text of one saved document. The text comes back as plain text: Grammarly shows uploaded files as plain text, and formatting such as bold, lists and headers is not returned. The document must be on your dashboard, not in Trash.

  MCP callgrammarly_read → get_document

  REST endpointGET https://cotlet.dev/api/v1/grammarly/documents/{document_id}

  Parameters

  Parameters: get_document

  Name	Type	Description
  document_id string required	string	A document_id from list_documents.

  Example input

  {
    "document_id": "document_8c41d2"
  }

  Example response

  {
    "document_id": "doc_7c21a9",
    "title": "Launch announcement",
    "text": "We are happy to announce that our new reporting tool is live today.",
    "updated_at": "2026-11-04T15:12:00Z"
  }

• create_document Create a document from pasted text. write

  Opens a new document with New document and pastes your text into it, as the Editor lets you do. The text is plain; formatting is not applied. The document is private to your account and nobody is notified, so the call does not wait for your OK. Undo it with delete_document.

  MCP callgrammarly_write → create_document

  REST endpointPOST https://cotlet.dev/api/v1/grammarly/documents

  Parameters

  Parameters: create_document

  Name	Type	Description
  text string required	string	The text to put in the new document.

  Example input

  {
    "text": "Hi team, the quarterly report is attached. Please send feedback by Friday."
  }

  Example response

  {
    "document_id": "doc_9b40d2",
    "title": "Untitled",
    "created_at": "2026-11-05T08:00:00Z"
  }

• delete_document Move one document to Trash. write

  Clicks the trash bin icon on the document in your list. Grammarly keeps it in Trash for 30 days and then deletes it for good. Until then restore_document brings it back, so the call does not wait for your OK.

  MCP callgrammarly_write → delete_document

  REST endpointDELETE https://cotlet.dev/api/v1/grammarly/documents/{document_id}

  Parameters

  Parameters: delete_document

  Name	Type	Description
  document_id string required	string	A document_id from list_documents.

  Example input

  {
    "document_id": "document_8c41d2"
  }

  Example response

  {
    "document_id": "doc_52fe08",
    "status": "trash",
    "delete_after": "2026-12-05"
  }

• restore_document Restore one document from Trash. write

  Opens Trash and clicks Restore on the document. It works within 30 days of deleting; after that Grammarly cannot recover the document. The document returns to your dashboard. It reaches nobody, so it does not wait for your OK.

  MCP callgrammarly_write → restore_document

  REST endpointPOST https://cotlet.dev/api/v1/grammarly/documents/{document_id}/restore

  Parameters

  Parameters: restore_document

  Name	Type	Description
  document_id string required	string	A document_id from list_documents with status trash.

  Example input

  {
    "document_id": "document_8c41d2"
  }

  Example response

  {
    "document_id": "doc_52fe08",
    "status": "active"
  }

• empty_trash Delete everything in Trash for good. writeasks first

  Clicks Empty Trash, which deletes every document in Trash permanently. Grammarly warns that the documents cannot be restored afterwards, so read Trash with list_documents first. By default you confirm each call; you can switch that off for this tool.

  MCP callgrammarly_write → empty_trash

  REST endpointPOST https://cotlet.dev/api/v1/grammarly/trash/empty

  Parameters

  No parameters.

  Example response

  {
    "deleted": 3
  }

ToolWhat it doesAccess

• get_writing_stats Overall score and statistics of one document. read

  Reads what the Overall score panel of the Editor shows for the document: the overall score and the statistics listed with it. The score reflects the document as it stands, with the goals set on it. Grammarly offers the same data as a PDF report in the Editor.

  MCP callgrammarly_read → get_writing_stats

  REST endpointGET https://cotlet.dev/api/v1/grammarly/documents/{document_id}/writing-stats

  Parameters

  Parameters: get_writing_stats

  Name	Type	Description
  document_id string required	string	A document_id from list_documents.

  Example input

  {
    "document_id": "document_8c41d2"
  }

  Example response

  {
    "document_id": "doc_7c21a9",
    "overall_score": 84,
    "word_count": 412,
    "goals": {
      "domain": "Business",
      "formality": "Formal"
    }
  }

• list_suggestions Open suggestion cards of one document. read

  Lists the suggestion cards Grammarly shows beside the document. Each has an id, the underline color (red, blue, green or purple), the text it applies to, the suggested change and the explanation from its Learn more link. Gray underlines appear when a team style guide is in use. Suggestions you dismissed are not listed.

  MCP callgrammarly_read → list_suggestions

  REST endpointGET https://cotlet.dev/api/v1/grammarly/documents/{document_id}/suggestions

  Parameters

  Parameters: list_suggestions

  Name	Type	Description
  document_id string required	string	A document_id from list_documents.
  color string	string	Only suggestions with this underline color: red, blue, green or purple.

  Example input

  {
    "document_id": "document_8c41d2"
  }

  Example response

  {
    "suggestions": [
      {
        "suggestion_id": "sg_103",
        "color": "red",
        "original": "recieve",
        "replacement": "receive",
        "explanation": "Misspelled word"
      },
      {
        "suggestion_id": "sg_104",
        "color": "blue",
        "original": "in order to",
        "replacement": "to",
        "explanation": "Shorter wording"
      }
    ]
  }

• resolve_suggestion Accept or dismiss one suggestion card. write

  Presses Accept on a suggestion card, which applies the change to the text, or Dismiss, which ignores it. It edits your own document only and the Editor can undo it, so it does not wait for your OK. Read the suggestion with list_suggestions first, because ids change when the text changes.

  MCP callgrammarly_write → resolve_suggestion

  REST endpointPOST https://cotlet.dev/api/v1/grammarly/documents/{document_id}/suggestions/{suggestion_id}/resolve

  Parameters

  Parameters: resolve_suggestion

  Name	Type	Description
  document_id string required	string	A document_id from list_documents.
  suggestion_id string required	string	A suggestion_id from list_suggestions.
  action string required	string	accept or dismiss.

  Example input

  {
    "document_id": "document_8c41d2",
    "suggestion_id": "suggestion_8c41d2",
    "action": "action"
  }

  Example response

  {
    "document_id": "doc_7c21a9",
    "suggestion_id": "sg_103",
    "action": "accept",
    "applied": true
  }

• set_goals Set audience, formality, domain and intent of one document. write

  Opens Goals for the document and sets the options you pass, then clicks Done. Grammarly cannot save default goals, so they are set per document. Pass each value as the option name the Goals panel shows. The domain option is limited to Pro, Plus, Business and Education plans. It reaches nobody and changing it again undoes it, so it does not wait for your OK.

  MCP callgrammarly_write → set_goals

  REST endpointPUT https://cotlet.dev/api/v1/grammarly/documents/{document_id}/goals

  Parameters

  Parameters: set_goals

  Name	Type	Description
  document_id string required	string	A document_id from list_documents.
  audience string	string	The Audience option as the Goals panel names it.
  formality string	string	The Formality option as the Goals panel names it.
  domain string	string	The Domain option as the Goals panel names it.
  intent string	string	The Intent option as the Goals panel names it.

  Example input

  {
    "document_id": "document_8c41d2"
  }

  Example response

  {
    "document_id": "doc_7c21a9",
    "goals": {
      "audience": "General",
      "formality": "Formal",
      "domain": "Business"
    }
  }

ToolWhat it doesAccess

• check_ai_and_plagiarism Run Check for AI text & plagiarism on one document. read

  Runs the Check for AI text & plagiarism button of the Editor and returns what its panel shows: passages that match external sources, each with the source Grammarly names, and the AI text result. The button belongs to paid plans, so on a free account the call fails with a plan error. It changes nothing in the document.

  MCP callgrammarly_read → check_ai_and_plagiarism

  REST endpointGET https://cotlet.dev/api/v1/grammarly/documents/{document_id}/ai-and-plagiarisms/check

  Parameters

  Parameters: check_ai_and_plagiarism

  Name	Type	Description
  document_id string required	string	A document_id from list_documents.

  Example input

  {
    "document_id": "document_8c41d2"
  }

  Example response

  {
    "document_id": "doc_7c21a9",
    "plagiarism_matches": [
      {
        "passage": "new reporting tool is live today",
        "source": "example.com/blog/reporting-tool"
      }
    ],
    "ai_text": {
      "flagged": false
    }
  }

• share_authorship_report Create the Authorship report of a document and a share link. writeasks first

  Opens the Authorship report of the document and sets access to Anyone with the link, then returns the link. Anyone who has the link sees all the information in the report. Authorship reports only the writing done while its tracking was on, so a document written without it has nothing to report. You can delete a shared report from your Authorship page in Grammarly. By default you confirm each call; you can switch that off for this tool.

  MCP callgrammarly_write → share_authorship_report

  REST endpointPOST https://cotlet.dev/api/v1/grammarly/documents/{document_id}/authorship-report/share

  Parameters

  Parameters: share_authorship_report

  Name	Type	Description
  document_id string required	string	A document_id from list_documents.

  Example input

  {
    "document_id": "document_8c41d2"
  }

  Example response

  {
    "document_id": "doc_7c21a9",
    "report_url": "https://www.grammarly.com/authorship/example-report",
    "access": "anyone_with_link"
  }

ToolWhat it doesAccess

• list_dictionary_words Words in your personal dictionary. read

  Lists the words on the Your dictionary page under Account, then Writing. Grammarly stops flagging these words in all its products. If your team admin turned the personal dictionary off on the Feature access page, the page is closed and the call fails.

  MCP callgrammarly_read → list_dictionary_words

  REST endpointGET https://cotlet.dev/api/v1/grammarly/dictionary-words

  Parameters

  No parameters.

  Example response

  {
    "words": [
      "Cotlet",
      "Superflow",
      "kubectl"
    ]
  }

• add_dictionary_word Add one word to your personal dictionary. write

  Types the word into the Your dictionary field and clicks Assign. A word can have at most 100 symbols, only English letters, hyphens and a few other symbols, and no spaces: entries with !, ?, +, $, & or / are refused, and so are several words in one entry. It reaches nobody and remove_dictionary_word undoes it, so it does not wait for your OK.

  MCP callgrammarly_write → add_dictionary_word

  REST endpointPOST https://cotlet.dev/api/v1/grammarly/dictionary-words

  Parameters

  Parameters: add_dictionary_word

  Name	Type	Description
  word string required	string	One word, up to 100 symbols, no spaces.

  Example input

  {
    "word": "word"
  }

  Example response

  {
    "word": "Superflow",
    "added": true
  }

• remove_dictionary_word Remove one word from your personal dictionary. write

  Finds the word on the Your dictionary page and clicks the trash bin icon next to it. Grammarly flags the word again afterwards. It reaches nobody and add_dictionary_word undoes it, so it does not wait for your OK.

  MCP callgrammarly_write → remove_dictionary_word

  REST endpointDELETE https://cotlet.dev/api/v1/grammarly/dictionary-words

  Parameters

  Parameters: remove_dictionary_word

  Name	Type	Description
  word string required	string	A word from list_dictionary_words.

  Example input

  {
    "word": "word"
  }

  Example response

  {
    "word": "kubectl",
    "removed": true
  }