🚀 Notion MCP Task Orchestrator

An automated, self-healing workflow orchestrator that reads tasks from your structured Notion database and executes them across GitHub, Instagram, and VS Code.

It can run locally as a Model Context Protocol (MCP) server with OpenCode, or in the cloud as a Vercel Serverless Function triggered by an automated Cron Job every 30 minutes.

🛠️ Architecture Options

Option 1: Vercel Cloud with Cron (Recommended for Cloud Tasks)

This executes GitHub and Instagram tasks automatically every 30 minutes in the background, without needing to keep a terminal window open. Note: VS Code tasks cannot be processed in the cloud because Vercel does not have access to your local machine.

Option 2: Local OpenCode (For Local & Cloud Tasks)

This runs the codebase as an MCP server. It handles all task types, including opening folders and executing commands inside your local VS Code application.

Related MCP server: MCP Notion Server (@suncreation)

🚀 Step-by-Step Vercel Hosting & Cron Setup

1. Deploy to Vercel:

   • Go to vercel.com and sign in.

   • Click Add New → Project.

   • Import your repository https://github.com/Shravan44s/MCP.

2. Add Environment Variables: In your Vercel Project settings under Environment Variables, add the following:

   • NOTION_TOKEN — Your Notion integration token (ntn_...)

   • NOTION_DATABASE_ID — Your Notion task database ID (38eed919-4589-81b4-a6fe-d092d6efecf1)

   • GITHUB_TOKEN — Your GitHub Personal Access Token (ghp_...)

   • CRON_SECRET — A secure, secret password of your choice (e.g. my-super-secret-cron-key). Vercel uses this to authenticate the cron trigger.

3. Deploy:

   • Click Deploy. Vercel will build the project and map the automated cron job using the configuration in vercel.json.

📸 Connecting Instagram

Instagram content publishing requires a Professional Business or Creator Account connected to a Facebook Page under the Meta Graph API structure.

Step 1: Account Preparation

1. Open the Instagram app → Go to Settings → Account type and tools → Switch to Professional Account (choose Business or Creator).

2. Create a Facebook Page (if you don't have one).

3. Connect your Instagram Professional Account to your Facebook Page (in Instagram Settings or Facebook Page Settings).

Step 2: Meta App Setup

1. Go to the Meta for Developers Portal and register as a developer.

2. Click Create App → Select Other → Business app type.

3. Add the Instagram Graph API product to your app.

Step 3: Get Credentials

1. Go to the Graph API Explorer tool.

2. Request the following permissions:

   • instagram_basic

   • instagram_content_publish

   • instagram_manage_insights

   • pages_show_list

   • pages_read_engagement

3. Generate a long-lived user access token.

4. Query the API (GET /me/accounts) to get your connected Facebook page access tokens and select your Instagram Business Account ID.

Step 4: Configure ig-mcp on OpenCode

Once you have the credentials, add them to your opencode.jsonc file:

"ig-mcp": {
  "enabled": true,
  "type": "local",
  "command": ["uvx", "ig-mcp"],
  "environment": {
    "INSTAGRAM_ACCESS_TOKEN": "YOUR_LONG_LIVED_ACCESS_TOKEN",
    "INSTAGRAM_BUSINESS_ACCOUNT_ID": "YOUR_INSTAGRAM_BUSINESS_ACCOUNT_ID"
  }
}

✈️ Connecting Telegram

You can get instant notifications on your phone whenever a Notion task runs or execute custom Telegram notification tasks.

Step 1: Create a Bot

1. Start a chat with @BotFather on Telegram.

2. Send /newbot and follow the prompts to choose a name and username.

3. Save the HTTP API Token (looks like 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ).

Step 2: Get Your Chat ID

1. Start a chat with @userinfobot on Telegram and send a message.

2. It will reply with your Id (e.g. 987654321). This is your Chat ID.

Step 3: Configure Environment Variables

Add these to your local .env file or Vercel Environment Variables:

• TELEGRAM_BOT_TOKEN — Your Bot token from Step 1

• TELEGRAM_CHAT_ID — Your Chat ID from Step 2

Once set, the orchestrator will automatically notify your phone whenever any task is run in the background by Vercel! You can also target Telegram as a Platform in Notion, and it will forward the Task Name/Details to your Telegram.

📋 Notion Database Layout

The auto-generated database contains the following columns: