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")

Related MCP server: DocGen MCP Server

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