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:

4. Build the project:

Usage

Run the server with your Docswrite token:

Example Flows

1. Create and Publish Flow

2. Search and Update Flow

3. Document Management Flow