Blogger Server

An MCP (Model Context Protocol) server that provides Claude and other MCP-compatible AI assistants with full access to the Google Blogger API v3. Supports reading, creating, updating, publishing, and deleting blog posts through natural language.

Features

• Blog management — List all blogs under your account, get blog metadata
• Post lifecycle — Create drafts, edit, publish, revert to draft, delete
• Read operations — List posts, retrieve individual posts, search by keyword
• Draft-first workflow — Posts are created as drafts by default for safety, then published explicitly
• Dual authentication — API Key for read-only access, OAuth 2.0 for full read/write access
• File-based content — Load post content from local HTML files (recommended for content > 10KB)
• Automatic token management — OAuth tokens are cached, refreshed, and persisted automatically to ~/.config/mcp-blogger/
• Default blog — Set DEFAULT_BLOG_ID to skip passing blogId on every tool call

Project Structure

mcp-blogger/
├── index.js          # Main MCP server — tool definitions and handlers
├── oauth.js          # OAuth 2.0 authentication flow
└── package.json      # Project metadata and dependencies

Prerequisites

• Node.js >= 22
• A Google Cloud project with the Blogger API enabled
• A Blogger API Key (for read operations) and/or OAuth 2.0 credentials (for write operations)

Installation

git clone https://github.com/aleck31/mcp-blogger.git
cd mcp-blogger
npm install

Authentication

This server supports two authentication methods. At least one must be configured:

• API Key only — read-only operations (get_blog_info, list_posts, get_post, search_posts)
• OAuth only — full read and write operations
• Both — API Key for reads, OAuth for writes

1. Get a Blogger API Key (read-only access)

1. Go to the Google Cloud Console
2. Create a project (or select an existing one)
3. Enable the Blogger API v3 under APIs & Services > Library
4. Go to APIs & Services > Credentials
5. Click Create Credentials > API key
6. Copy the generated API key

2. Get OAuth 2.0 Credentials (read + write access)

1. In the same Google Cloud project, go to APIs & Services > Credentials
2. Click Create Credentials > OAuth client ID
3. Select Web application as the application type
4. Add http://localhost:3000/oauth/callback to Authorized redirect URIs
5. Copy the Client ID and Client Secret

3. OAuth Flow (automatic)

On the first write operation, the server will automatically:

1. Start a temporary local HTTP server on port 3000
2. Open your browser to the Google OAuth consent page
3. After you grant access, capture the authorization code via the callback URL
4. Exchange the code for access and refresh tokens
5. Persist tokens to ~/.config/mcp-blogger/tokens.json

Subsequent write operations reuse cached tokens and refresh them automatically when expired. The OAuth flow times out after 5 minutes if not completed.

Configuration

Set the following environment variables in your MCP client configuration:

Variable	Required	Description
BLOGGER_API_KEY	For read ops	Google Blogger API key
GOOGLE_CLIENT_ID	For write ops	OAuth 2.0 Client ID
GOOGLE_CLIENT_SECRET	For write ops	OAuth 2.0 Client Secret
DEFAULT_BLOG_ID	No	Default Blog ID, used when blogId is omitted from tool calls

MCP Config Example

Add the server to your Agent MCP configuration file (such as mcp_config.json):

{
  "mcpServers": {
    "blogger": {
      "command": "npx",
      "args": ["-y", "mcp-blogger"],
      "env": {
        "BLOGGER_API_KEY": "your-api-key",
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret",
        "DEFAULT_BLOG_ID": "your-default-blog-id"
      }
    }
  }
}

Claude Code

Add the server via the Claude Code CLI:

claude mcp add blogger -- npx -y mcp-blogger \
  -e BLOGGER_API_KEY=your-api-key \
  -e GOOGLE_CLIENT_ID=your-client-id \
  -e GOOGLE_CLIENT_SECRET=your-client-secret \
  -e DEFAULT_BLOG_ID=your-default-blog-id

Tools

All tools that accept blogId will fall back to DEFAULT_BLOG_ID if set.

Category	Tool	OAuth	Description
Account	list_blogs	Yes	List all blogs owned by the authenticated user
Read	get_blog_info	No	Get blog metadata by URL or ID
Read	list_posts	No	List published posts
Read	get_post	No	Get a specific post (supports drafts with OAuth)
Read	search_posts	No	Search posts by keyword
Write	list_drafts	Yes	List draft posts
Write	create_post	Yes	Create a post (draft by default). Use content_file for large content
Write	change_post_status	Yes	Publish a draft or revert a published post to draft
Write	update_post	Yes	Update a post (supports both published and draft)
Write	delete_post	Yes	Delete a post

Typical Workflow

list_blogs                          # Find your blog ID
create_post (draft by default)      # Write content
get_post                            # Preview the draft
update_post                         # Revise if needed
change_post_status action=publish   # Go live
change_post_status action=revert    # Unpublish if needed

Dependencies

• @modelcontextprotocol/sdk — MCP server framework
• googleapis — Google API client (Blogger API v3)
• express — Local HTTP server for OAuth callback
• open — Opens browser for OAuth consent

License

MIT