Grammarly Integration

Pro v1.0.0

Access Grammarly's enterprise APIs for writing quality evaluation, AI detection, analytics, and license management

Requires Claude Code CLI

This skill integrates with Grammarly through Claude Code. Install Claude Code and add this skill to use it.

Available Actions

Score Document

Submit a document for writing quality evaluation and receive scores for correctness, clarity, engagement, and delivery

Parameters

Name Type Required Description
filename string Required Name of the document being scored
file_path string Required Local path to the document file

Returns

object Score request ID for checking results

Try saying...

  • "Check the writing quality of this document"
  • "Score this report for grammar and clarity"
  • "Evaluate the writing in proposal.docx"
  • "Get a Grammarly score for this article"

Get Score Results

Retrieve the evaluation results for a previously submitted document

Parameters

Name Type Required Description
score_request_id string Required ID returned from score-document action

Returns

object Document scores and status

Try saying...

  • "Get the writing score for request ABC123"
  • "Check if my document score is ready"
  • "Show me the results for score request XYZ"
  • "Has the document evaluation completed?"

List Users

Get usage data and analytics for users in your organization

Parameters

Name Type Required Description
limit integer Optional Number of users to return
date_from string Optional Start date for analytics (YYYY-MM-DD)
date_to string Optional End date for analytics (YYYY-MM-DD)

Returns

array List of users with activity and usage statistics

Try saying...

  • "Show me the team's Grammarly usage for October"
  • "List all users who used Grammarly last month"
  • "Get user analytics for our organization"
  • "Who has been using Grammarly?"

Get Institution Summary

Retrieve organization subscription summary and license information

Returns

object Subscription details, license count, and organization info

Try saying...

  • "Show me our Grammarly subscription details"
  • "How many licenses do we have?"
  • "Get our institution summary"
  • "What's our current Grammarly plan?"

Getting Started

OAuth 2.0 Moderate Setup
  1. 1 Log in to Grammarly Admin panel
  2. 2 Navigate to Organization > OAuth 2.0 credentials
  3. 3 Click Add credential
  4. 4 Enter a name and select required APIs
  5. 5 Click Create and copy Client ID and Secret
  6. 6 Add credentials to shell config: echo 'export GRAMMARLY_CLIENT_ID="YOUR_ID"' >> ~/.zshrc
  7. 7 Add secret: echo 'export GRAMMARLY_CLIENT_SECRET="YOUR_SECRET"' >> ~/.zshrc
  8. 8 Restart terminal or run: source ~/.zshrc

Verify Setup

python scripts/client.py get-institution-summary

Success: JSON response with institution details

View full setup guide

Security & Access

Access Scope

Full access to organization's Grammarly data including document content, user analytics, license management, and ability to submit documents for evaluation

  • OAuth credentials grant access to all organization data within selected scopes
  • Documents submitted for scoring are uploaded to Grammarly's servers
  • Store credentials securely - never commit to version control
  • Rotate credentials immediately if exposure is suspected
  • Only grant minimum required scopes for your use case
  • Admin privileges required to create OAuth credentials

Limitations

  • Requires Grammarly Enterprise or Education plan
  • Document size limited to 4 MB
  • Text length: 30-100,000 characters
  • Results retained for 30 days only
  • Documents deleted within 24 hours
  • OAuth credentials must be created by organization admin

Get This Skill

Requires Pro subscription ($9/month)

Quick Reference

Type
REST API
Auth
OAuth 2.0
Setup
Moderate Setup
Tools Required
Bash
Python Dependencies
requests>=2.28.0

Documentation

Have Feedback?

Help us improve this skill by sharing your ideas and suggestions.

Request Improvements