claude-productivity-mcp

🇹🇭 ภาษาไทย | 🇬🇧 English

MCP Server สำหรับ Claude Desktop ที่รวม productivity tools ยอดนิยมไว้ในที่เดียว — Gmail, Google Calendar, Google Drive, Google Sheets, Notion และ Microsoft Outlook ควบคุมได้ง่ายผ่าน .env ไม่ต้องแก้โค้ด

ใช้กับ Claude Desktop ผ่านโปรโตคอล Model Context Protocol (MCP)

MCP คืออะไร?

Model Context Protocol (MCP) คือโปรโตคอลมาตรฐานที่ช่วยให้ Claude Desktop เชื่อมต่อกับ tools และ services ภายนอกได้โดยตรง แทนที่จะต้อง copy-paste ข้อมูลระหว่างแอป คุณสามารถพูดกับ Claude ว่า:

• "สรุปอีเมลที่ยังไม่ได้อ่านวันนี้ให้หน่อย"

• "เพิ่ม event ประชุมพรุ่งนี้ 10 โมงใน Calendar"

• "ค้นหาไฟล์ proposal ใน Drive แล้วบอกว่าอัปเดตล่าสุดเมื่อไหร่"

• "เพิ่มแถวค่าใช้จ่ายวันนี้ใน Google Sheets"

Claude จะดำเนินการให้เองทันที ไม่ต้องเปิดแอปอื่น

Related MCP server: Google Services MCP Server

Tools ที่รองรับ

Google (Gmail + Calendar + Drive + Sheets)

Notion

Microsoft Outlook

Requirements

• Node.js v18 ขึ้นไป

• Claude Desktop

• บัญชี Google (สำหรับ Gmail/Calendar/Drive/Sheets)

• บัญชี Microsoft 365 (สำหรับ Outlook — optional)

• บัญชี Notion (สำหรับ Notion — optional)

Installation

# 1. Clone repo
git clone https://github.com/kmusicman/claude-productivity-mcp.git
cd claude-productivity-mcp

# 2. ติดตั้ง dependencies
npm install

# 3. Copy ไฟล์ config
cp .env.example .env

Setup

1. Google (Gmail + Calendar + Drive + Sheets)

1.1 เปิดใช้งาน Google APIs

1. ไปที่ Google Cloud Console

2. สร้าง Project ใหม่ หรือเลือก Project ที่มีอยู่

3. ไปที่ APIs & Services → Library แล้วเปิดใช้งาน API ต่อไปนี้:

   • Gmail API

   • Google Calendar API

   • Google Drive API

   • Google Sheets API

1.2 สร้าง OAuth 2.0 Credentials

1. ไปที่ APIs & Services → Credentials

2. คลิก Create Credentials → OAuth client ID

3. เลือก Application type: Desktop app

4. ตั้งชื่อตามต้องการ แล้วคลิก Create

5. คลิก Download JSON

6. Rename ไฟล์ที่ดาวน์โหลดมาเป็น oauth2.keys.json

7. วางไฟล์ที่ credentials/oauth2.keys.json

หากยังไม่ได้ตั้งค่า OAuth consent screen ให้ไปที่ APIs & Services → OAuth consent screen ตั้งค่าเป็น External และเพิ่ม email ตัวเองเป็น Test user

1.3 รัน Setup

npx tsx src/setup-google-auth.ts

Browser จะเปิดขึ้นมาให้ login Google → อนุญาต permissions → token จะถูกบันทึกอัตโนมัติที่ credentials/google-token.json

2. Notion

2.1 สร้าง Notion Integration

1. ไปที่ https://www.notion.so/my-integrations

2. คลิก New integration

3. ตั้งชื่อ เช่น Claude MCP

4. เลือก workspace ที่ต้องการ

5. คลิก Submit

6. Copy Internal Integration Token

2.2 เชื่อมต่อ Database

1. เปิด Notion Database ที่ต้องการใช้งาน

2. คลิก ... (มุมขวาบน) → Connections → เลือก integration ที่สร้างไว้

3. Copy Database ID จาก URL: https://notion.so/YOUR_DATABASE_ID?v=...

2.3 บันทึก Credentials

สร้างไฟล์ credentials/notion.json:

{
  "apiKey": "ntn_YOUR_NOTION_API_KEY",
  "databaseId": "YOUR_DATABASE_ID"
}

3. Microsoft Outlook

3.1 สร้าง Azure App Registration

1. ไปที่ Azure Portal

2. ค้นหา App registrations → New registration

3. ตั้งชื่อ เช่น Claude MCP

4. Supported account types: Personal Microsoft accounts only

5. Redirect URI: http://localhost:5555/oauth/callback (Platform: Web)

6. คลิก Register

3.2 เพิ่ม API Permissions

1. ไปที่ API permissions → Add a permission → Microsoft Graph

2. เลือก Delegated permissions และเพิ่ม:

   • Mail.Read

   • Mail.ReadWrite

   • Mail.Send

3. คลิก Grant admin consent

3.3 สร้าง Client Secret

1. ไปที่ Certificates & secrets → New client secret

2. ตั้งชื่อและเลือกอายุ → คลิก Add

3. Copy Value ทันที (จะมองเห็นแค่ครั้งเดียว)

3.4 บันทึก Credentials

สร้างไฟล์ credentials/ms365.keys.json:

{
  "clientId": "YOUR_AZURE_CLIENT_ID",
  "clientSecret": "YOUR_AZURE_CLIENT_SECRET",
  "tenantId": "consumers"
}

3.5 รัน Setup

npx tsx src/setup-outlook-auth.ts

4. Build

npm run build

เชื่อมต่อกับ Claude Desktop

1. เปิดไฟล์ config ของ Claude Desktop:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. เพิ่ม config ต่อไปนี้:

{
  "mcpServers": {
    "productivity-mcp": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/claude-productivity-mcp/dist/index.js"]
    }
  }
}

แทนที่ /ABSOLUTE/PATH/TO/ ด้วย path จริงบนเครื่องของคุณ

3. Restart Claude Desktop

Configuration

เปิด/ปิด service แต่ละตัวได้ที่ไฟล์ .env:

ENABLE_GOOGLE=true    # Gmail + Calendar + Drive + Sheets
ENABLE_NOTION=true
ENABLE_OUTLOOK=true

ตั้งเป็น true เพื่อเปิดใช้งาน, false หรือลบออกเพื่อปิด

ตัวอย่างการใช้งาน

"สรุปอีเมลที่ยังไม่ได้อ่านใน Gmail 5 ฉบับล่าสุดให้หน่อย"

"เพิ่ม event ประชุมทีม วันพรุ่งนี้ 10:00-11:00 น. ใน Google Calendar"

"ค้นหาไฟล์ที่มีคำว่า proposal ใน Google Drive"

"อ่านข้อมูลจาก Sheet1 แถว A1:D10 ใน spreadsheet นี้: [spreadsheet ID]"

"ส่งอีเมลหา someone@example.com หัวเรื่อง 'สวัสดี' เนื้อหา 'ทดสอบระบบ'"

License

MIT