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