task-mcp-learning
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Task Manager — MCP Server + Next.js
A small but complete example that demonstrates every core Model Context Protocol (MCP) concept, wired to a Next.js web app that shares the same data.
An AI client (e.g. Claude Desktop) talks to the MCP server to read and change tasks; the Next.js UI shows those same tasks and updates live.
┌────────────────┐ MCP (stdio / JSON-RPC) ┌───────────────────────┐
│ AI client │ ─────────────────────────► │ mcp-server/server.ts │
│ (Claude etc.) │ tools · resources · │ Resources / Tools / │
└────────────────┘ prompts │ Prompts / Transport │
└──────────┬────────────┘
│ reads/writes
▼
┌───────────────────────┐
┌────────────────┐ HTTP / REST │ lib/store.ts │
│ Web browser │ ─────────────────────────► │ data/tasks.json │
│ (Next.js UI) │ /api/tasks │ (shared file store) │
└────────────────┘ └───────────────────────┘MCP concepts demonstrated
Concept | Where | Examples |
Resources |
|
|
Tools |
|
|
Prompts |
|
|
Transport |
| stdio (Claude Desktop compatible) |
Related MCP server: task-manager-mcp
Project structure
lib/store.ts # Shared, file-backed task store (single source of truth)
mcp-server/server.ts # The MCP server: resources + tools + prompts + stdio
mcp-server/smoke-test.ts # End-to-end MCP client test (uses the official SDK Client)
app/page.tsx # Task manager web UI
app/api/tasks/route.ts # REST: GET (list/search) + POST (create)
app/api/tasks/[id]/route.ts # REST: GET / PATCH / DELETE one task
claude_desktop_config.json # Example config to connect Claude DesktopRun it
1. The web app
npm run dev
# open http://localhost:30002. The MCP server (standalone)
npm run mcp # runs the server over stdio
npm run mcp:inspect # opens the MCP Inspector UI to click through tools/resources/prompts3. End-to-end smoke test
npx tsx mcp-server/smoke-test.tsExercises the full MCP surface: lists tools/resources/templates/prompts, calls a tool, reads resources, and fetches a prompt.
Connect to Claude Desktop
Add the mcpServers block from claude_desktop_config.json to your Claude Desktop
config (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json),
adjusting cwd to this project's absolute path. Restart Claude Desktop, then ask it
to "create a task" or "summarize my tasks" — the changes appear in the web UI too.
How the two sides stay in sync
Both the MCP server process and the Next.js API import the same lib/store.ts, which
persists to data/tasks.json. Anything the AI does through MCP is immediately visible
in the browser (the UI polls every 3s), and vice-versa — verified across separate
processes.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Headless task management for bots, apps and AI agents. Remote MCP server, OAuth or access token.
Local-first task manager: create, edit, and complete tasks, projects, and checklists via MCP.
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
Related MCP Servers
- FlicenseBqualityDmaintenanceA comprehensive task management MCP server built with FastMCP, featuring full CRUD operations, intelligent filtering, and productivity-focused prompts.71-
- FlicenseNot gradedqualityDmaintenanceA task manager MCP server that demonstrates all three MCP primitives (tools, resources, prompts). Enables users to manage tasks, read task summaries and details, and run structured planning/review prompts through natural language.-
- AlicenseNot gradedqualityDmaintenanceAn example MCP server using mcp-handler to integrate MCP tools, prompts, and resources into any Next.js project.MIT
- FlicenseCqualityDmaintenanceA simple MCP server for managing tasks via a local JSON file, demonstrating resources, tools, and prompts for task reading, creation, and analysis.1-