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

Create a Google Cloud Project and enable:
- Google Docs API
- Google Drive API
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
Install dependencies:

npm install

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