blogger-mcp

A custom MCP server based on the Google Blogger API v3. It provides tools for MCP hosts like Claude Code / Claude Desktop to list, create, edit, and delete posts on your Blogger blog.

Key Features (MCP Tools)

Related MCP server: MCP-Google-Doc

Architecture

Claude Code ──stdio──► blogger-mcp (Node)
                          │
                          ├─ src/index.ts     : MCP server (tools 등록/디스패치)
                          ├─ src/auth.ts      : OAuth 2.0 토큰 로드/저장/갱신
                          └─ src/auth-cli.ts  : 최초 1회 대화형 인증용 CLI
                          │
                          ▼
                  Google Blogger API v3

• Authentication: OAuth 2.0 (Desktop app). Run npm run auth once to launch a local callback server, receive the token, and save it to ~/.config/blogger-mcp/token.json. It is automatically refreshed using a refresh token thereafter.

• Scopes: https://www.googleapis.com/auth/blogger

• Transport: stdio (MCP host launches as a child process)

Quick Start

1. Installation and Build

git clone https://github.com/mech12/blogger-mcp.git
cd blogger-mcp
npm install
npm run build

2. Prepare OAuth Client

Enable Blogger API v3 in the Google Cloud Console, create a Desktop app type OAuth client, and download client_secret.json.

mkdir -p ~/.config/blogger-mcp
cp /path/to/client_secret.json ~/.config/blogger-mcp/client_secret.json

For detailed Google Cloud configuration, refer to Blogger API v3 Authentication Issuance below.

3. Initial Authentication

npm run auth

Open the URL displayed in your browser and grant permission to generate ~/.config/blogger-mcp/token.json.

4. Register with Claude Code

claude mcp add blogger --scope user -- node /absolute/path/to/blogger-mcp/dist/index.js

Or directly in ~/.claude.json:

{
  "mcpServers": {
    "blogger": {
      "command": "node",
      "args": ["/absolute/path/to/blogger-mcp/dist/index.js"]
    }
  }
}

Environment Variables

Blogger API v3 Authentication Issuance (Summary)

1. Create a Google Cloud Project — https://console.cloud.google.com/

2. Enable Blogger API v3 in the API Library

3. Configure OAuth Consent Screen

   • User Type: External

   • Add Scope: https://www.googleapis.com/auth/blogger

   • Add your Google account as a test user

4. Credentials → OAuth Client ID

   • Application type: Desktop app

   • Download JSON after creation → ~/.config/blogger-mcp/client_secret.json

5. Verify Blog ID

   • Use the blogID=... number from the Blogger admin URL or the get_blog_by_url tool.

Detailed project-specific guides are managed in docs/vibe/mcp/blogger-mcp.md of the host project.

Design Notes

• Stack: TypeScript + Node 18+, @modelcontextprotocol/sdk, googleapis, google-auth-library.

• Token Storage: ~/.config/blogger-mcp/. Protected by .gitignore.

• Error Strategy: Tool call failures are automatically wrapped by MCP. If authentication is missing, guide the user with the message No stored token. Run npm run auth first..

• Expansion Roadmap:

  • Markdown → HTML conversion tool (based on marked)

  • Image upload (Blogger requires bypassing Picasa/Google Photos → future option)

  • Scheduled publishing (setting the published field)

Development

npm run dev       # tsc --watch
npm run build     # dist/ 생성
npm start         # dist/index.js 실행 (MCP stdio 서버)
npm run auth      # OAuth 최초 인증

License

MIT