Skip to content Plug any tool into any agent. MCP servers for people who do not write servers. Gateway for volume, n8n for apps.
Product
Directory
Developers
Company
Task Scheduler Codex Plugin MCP server | PlugMCP
Skip to content From the publisher
Documentation Task Scheduler for OpenAI Codex
Task Scheduler is an OpenAI Codex plugin that turns raw task lists into realistic schedules.
It combines three pieces in one plugin package:
a Codex plugin manifest and marketplace-ready metadata
a reusable MCP server that other agents and tools can call
a local CLI for generating schedule drafts from structured JSON input
OpenAI Codex plugin and MCP server for turning task lists into realistic schedules.
Plug any tool into any agent. MCP servers for people who do not write servers. Gateway for volume, n8n for apps.
Product
Directory
Developers
Company
The plugin is designed for practical planning. It balances deadlines, available hours, blocked dates, and per-day capacity changes, then returns a markdown plan with follow-ups and risks.
Highlights
Converts task JSON into a day-by-day schedule
Supports blocked dates and daily capacity overrides
Tracks overflow when tasks do not fit inside the planning window
Exposes MCP tools so other agents can call the scheduler directly
Includes a Codex skill for planning-oriented prompts
Ships with example assets, sample data, and starter plugin metadata
Who This Is For
Codex users who want a local productivity plugin
plugin authors learning how to combine plugin manifests, skills, and MCP
teams that want a lightweight planning tool agents can call from the same workspace
Repository Layout task-scheduler/
|-- .codex-plugin/
| `-- plugin.json
|-- assets/
| |-- icon.png
| |-- logo.png
| `-- screenshot*.png
|-- hooks/
| `-- README.md
|-- scripts/
| |-- build_schedule.py
| |-- example_tasks.json
| |-- mcp_server.py
| |-- requirements-mcp.txt
| `-- task_scheduler_core.py
|-- skills/
| `-- task-planner/
| `-- SKILL.md
|-- .app.json
|-- .mcp.json
|-- hooks.json
`-- README.md
Features
1. Local CLI scheduling Use the CLI when you want a quick schedule from a JSON file:
python .\scripts\build_schedule.py `
--input .\scripts\example_tasks.json
--start-date YYYY-MM-DD
--days <int>
--hours-per-day <number>
--output <path>
These flags override the values inside the JSON input file when present.
2. MCP tools for agent workflows The plugin exposes a local stdio MCP server so other agents and tools can call the scheduler without shelling out directly.
build_task_schedule
analyze_schedule_capacity
build_task_schedule_from_file
Implemented MCP resources:
task-scheduler://sample-input
task-scheduler://readme
3. Codex skill support The included skill at skills/task-planner/SKILL.md helps Codex gather constraints, create a realistic plan, and call out risk and overflow clearly.
Input Format The scheduler accepts either:
a plain JSON array of tasks
a JSON object containing tasks plus planning metadata
Minimal input [
{
"title": "Finalize project brief",
"due": "2026-04-03",
"estimated_hours": 2.5,
"priority": 5,
"notes": "Needs stakeholder review"
}
]
Full input {
"start_date": "2026-04-01",
"days": 6,
"hours_per_day": 6,
"blocked_dates": ["2026-04-04"],
"daily_capacity_overrides": {
"2026-04-03": 3.5,
"2026-04-06": 4
},
"notes": "Protect Saturday for admin catch-up.",
"tasks": [
{
"title": "Finalize project brief",
"due": "2026-04-02",
"estimated_hours": 2,
"priority": 5,
"tags": ["strategy", "stakeholders"],
"notes": "Share with stakeholders before noon."
}
]
}
Supported task fields
title: task name
due: due date in YYYY-MM-DD
estimated_hours: expected work in hours
priority: integer from 1 to 5
notes: optional detail shown in output
tags: optional string array for categorization
Supported schedule metadata
start_date: planning window start
days: number of days in the window
hours_per_day: default daily capacity
blocked_dates: dates with zero scheduling capacity
daily_capacity_overrides: per-day hour overrides
notes: planning context echoed into the output
Example Output The generated markdown includes:
Summary
Schedule
Follow-Ups
Risks
This makes it readable for humans and easy for agents to refine.
Installation
1. Clone or copy the repository This repository is structured with the plugin at the repo root.
task-scheduler-codex-plugin/
To use it as a Codex plugin inside another workspace, place this repository or a copy of it under:
2. Install the MCP dependency python -m pip install -r .\scripts\requirements-mcp.txt
3. Verify the plugin manifest .codex-plugin/plugin.json
This plugin already references:
./skills/
./hooks.json
./.mcp.json
./.app.json
4. Verify the MCP config It starts the local server with:
{
"mcpServers": {
"taskScheduler": {
"command": "python",
"args": ["./scripts/mcp_server.py"],
"cwd": "."
}
}
}
5. Optional marketplace registration If you want the plugin to appear in Codex UI ordering, register it in your marketplace file:
.agents/plugins/marketplace.json
This repo already includes a starter marketplace entry.
Quick Start
Run the CLI python .\scripts\build_schedule.py `
--input .\scripts\example_tasks.json
Start the MCP server directly python .\scripts\mcp_server.py
Use the example data scripts/example_tasks.json
Documentation
Current Status This plugin is a strong local starter and learning reference. It is already useful for local scheduling and MCP-based planning flows, but a few areas are still intentionally starter-level:
.app.json integration details
runtime hook registrations in hooks.json
final production screenshots and branding assets
Roadmap Ideas
add more MCP tools such as automatic overflow rescheduling
support recurring tasks and dependency chains
add export formats beyond markdown
connect planner output to external task systems
add repository releases and changelog automation
License MIT, unless you choose a different license for your public repository.
Directory score 10/100 Listed 10 of 10
In the official MCP Registry 0 of 18
Claimed by its maintainer 0 of 8
Answers with a tool list 0 of 12
GitHub stars 4 of 16
Weekly downloads 0 of 10
Public Apis A collective list of free APIs Pipeworx Gateway Live data for AI agents. 250+ data sources, 900+ tools. Ask questions in plain English with ask_pipeworx — trade flows, SEC filings, drug safety, housing data, and more. No API keys needed. Rea Reverse engineer anything with agents, from app behavior down to native binaries. Coding Interview University A complete computer science study plan to become a software engineer. Skills Skills for Real Engineers. Straight from my .agents directory. Hermes Agent The agent that grows with you SparkForge Access a versatile collection of tools for media generation, web scraping, and cryptocurrency research. Convert between data formats, summarize long documents, and extract text from images or PDFs wit N8n Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations. Awesome Go A curated list of awesome Go frameworks, libraries and software Ohmyzsh 🙃 A delightful community-driven (with 2,500+ contributors) framework for managing your zsh configuration. Includes 300+ optional plugins (rails, git, macOS, hub, docker, homebrew, node, php, python Agency Agents A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, a The Art Of Command Line Master the command line, in one page agent-browser Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web a azure-aigateway Configure Azure API Management as an AI Gateway for AI models, MCP tools, and agents. WHEN: semantic caching, token limit, content safety, load balancing, AI model governance, MCP rate limiting, jailb
No tool list yet. Remote servers get one after the first health check.
How do I install Task Scheduler Codex Plugin? Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does Task Scheduler Codex Plugin need an API key? No required environment variable is listed on this record.
What transport does Task Scheduler Codex Plugin use? Task Scheduler Codex Plugin runs locally over stdio.
When was Task Scheduler Codex Plugin last checked? Last checked 2026-10-26. OpenAI Codex plugin and MCP server for turning task lists into realistic schedules.
azure-compute Azure VM/VMSS router. WHEN: create / provision / deploy / spin-up VM, recommend VM size, compare VM pricing, VMSS, scale set, autoscale, burstable, lightweight server, website, backend, GPU, machine l Tools have descriptions 0 of 6