Docswrite MCP - Cursor to Google Docs to WordPress (or any CMS)

Google Docs to WordPress MCP, generate content from Cursor, add it to Google Docs and use Docswrite to publish it to your favorite WordPress automatically

Installation Instructions

README: https://github.com/Docswrite/docswrite-mcp

Docswrite MCP Server

Docswrite created the first in the world MCP to write to Google Docs and turn the google docs into a perfectly formatted post on WordPress.

This server provides tools for working with Google Docs, Google Drive, and WordPress through Docswrite.

Tools

1. Google Docs & Drive Tools

google-docs-create

Creates a new Google Docs document.

• title: The title of the new document
• content: The content to write to the document

google-docs-update

Updates an existing Google Docs document.

• documentId: The ID of the document to update
• content: The content to write to the document
• replaceAll (optional): Whether to replace all content (true) or append (false)

google-docs-search

Searches for Google Docs documents using Google Drive API.

• query: The search query to find documents
• Returns: List of documents with ID, name, creation time, and last modified time

google-docs-delete

Deletes a Google Docs document using Google Drive API.

• documentId: The ID of the document to delete

2. Docswrite Tools

docswrite-publish

Publishes content from Google Docs to WordPress.

• google_docs_url (required): URL of the Google Docs document
• title (optional): Title of the blog post
• slug (optional): URL slug for the post
• tags (optional): Comma-separated list of tags
• categories (optional): Comma-separated list of categories
• state (optional): Post state (draft/publish)
• author (optional): Author name
• date (optional): Publication date
• excerpt (optional): Post excerpt
• post_type (optional): Post type (post/page)
• featured_image_url (optional): URL of the featured image
• featured_image_alt_text (optional): Alt text for featured image
• featured_image_caption (optional): Caption for featured image
• export_settings (optional): Object containing:
  • compress_images: Boolean
  • demote_headings: Boolean
  • convert_to_webp: Boolean
  • first_image_as_featured_image: Boolean
  • add_no_follow_to_external_links: Boolean
  • bold_as_strong: Boolean
  • wp_content_editor: String
• newspack_settings (optional): Object containing:
  • newspack_article_summary: String
  • newspack_article_summary_title: String
  • newspack_post_subtitle: String
• yoast_settings (optional): Object containing:
  • yoast_focuskw: String
  • yoast_metadesc: String
  • yoast_title: String
• rankmath_settings (optional): Object containing:
  • rank_math_focus_keyword: String

docswrite-job-status

Checks the status of a Docswrite publishing job.

• jobId: The ID of the job to check
• queueType (optional): The type of queue (default: "post")

Project Structure

Source Files

• src/index.ts: Main server implementation and tool definitions

  • Initializes MCP server
  • Defines and registers all available tools
  • Handles command-line arguments and environment variables

• src/auth.ts: Google OAuth2 authentication handling

  • Manages OAuth2 flow for Google APIs
  • Handles token storage and refresh
  • Provides authorization for Google Docs and Drive APIs

• src/google-docs.ts: Google Docs and Drive API operations

  • Document creation and manipulation
  • Content updating and formatting
  • Document search and deletion
  • Error handling and response formatting

• src/docswrite-request.ts: Docswrite API integration

  • Handles requests to Docswrite service
  • Manages WordPress publishing queue
  • Job status checking and monitoring

• src/oauth-server.ts: OAuth callback server implementation

  • Handles OAuth2 callback from Google
  • Manages token exchange
  • Provides success/failure responses

• src/config.ts: Configuration management

  • Environment variables
  • API endpoints
  • Default settings

• src/utils.ts: Utility functions

  • Helper methods
  • Common operations
  • Shared types and interfaces

Setup

1. Create a Google Cloud Project and enable:

   • Google Docs API
   • Google Drive API

2. Configure OAuth2 credentials:

   • Create OAuth2 credentials in Google Cloud Console
   • Download and save as credentials.json in project root
   • Set redirect URI to http://localhost:3000/oauth2callback

3. Install dependencies:

npm install

4. Build the project:

npm run build

Usage

Run the server with your Docswrite token:

node dist/index.js --docswriteToken=your-docswrite-token

Example Flows

1. Create and Publish Flow

// 1. Create a new Google Doc
{
  "title": "My New Post",
  "content": "This is the content of my post."
}

// 2. Publish to WordPress
{
  "google_docs_url": "https://docs.google.com/document/d/your-doc-id/edit",
  "title": "My New Post",
  "state": "draft"
}

// 3. Check publishing status
{
  "jobId": "your-job-id"
}

2. Search and Update Flow

// 1. Search for documents
{
  "query": "WordPress"
}

// 2. Update a document
{
  "documentId": "your-doc-id",
  "content": "Updated content",
  "replaceAll": true
}

3. Document Management Flow

// 1. Create document
{
  "title": "Draft Post",
  "content": "Initial draft"
}

// 2. Update content
{
  "documentId": "your-doc-id",
  "content": "Additional content",
  "replaceAll": false
}

// 3. Publish to WordPress
{
  "google_docs_url": "https://docs.google.com/document/d/your-doc-id/edit",
  "title": "Final Post",
  "state": "publish",
  "categories": "tutorials",
  "tags": "wordpress, google-docs"
}