msplanner_get_tablesLABSCO SUMMARY
Planner as a queryable table, read-only.
Planner's own reporting is thin, and turning plans, buckets and tasks into SQL tables makes questions like "what is overdue across every plan" answerable in one query. The discipline is the same as the rest of this family: discover the schema, then query it, and nothing can write. The CData driver licence is the prerequisite to settle first.
What it is
A local MCP server built on the CData JDBC Driver for Microsoft Planner, which exposes Planner as relational SQL models. A model gets table discovery, column discovery and one read-only query tool. It runs over stdio, so the client has to be on the same machine.
What you get
- The Microsoft Planner tables the driver exposes, returned as CSV with a header row —
msplanner_get_tables - The columns of a chosen table, so queries reference real field names —
msplanner_get_columns - A SQL
SELECTagainst live Planner data —msplanner_run_query - A
Tablessetting that only picks which tables also get a ready-made description (blank means none); it does not limit what the tools can list or query, so limit the connection or the account it signs in with
Requirements
A Microsoft Planner account and a licensed CData JDBC Driver for Microsoft Planner — a trial licence works, applied with java -jar cdata.jdbc.msplanner.jar --license. Java to run the server, Maven to build it (mvn clean install produces CDataMCP-jar-with-dependencies.jar). The .prp connection file names DriverClass as cdata.jdbc.msplanner.MSPlannerDriver, the driver jar path, a tool Prefix such as msplanner, and the JDBC connection string generated by the driver's Connection String utility — since Planner uses OAuth, that step sends you through a browser sign-in. MIT licensed.
Setup effort
Build from source — git clone https://github.com/cdatasoftware/microsoft-planner-mcp-server-by-cdata.git
USE CASES
Reporting across plans
Ask the question in plain language; the model finds the table, checks its columns, and answers with one SELECT over live Planner data.
Working out what Planner actually exposes
List tables and columns to map the fields available before building a report around them.
3 tools
Listed in project docs. Your client may show a different list.
msplanner_get_columnsmsplanner_run_queryBEFORE YOU INSTALL
What to know first
Tools you get
3 tools named in the project's documentation. Tool names start with the Prefix in the .prp file, so the README's Prefix=msplanner gives msplanner_get_tables, msplanner_get_columns and msplanner_run_query. All three only read: run_query executes SELECT; write access is in CData's separate MCP Server product.
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
git clone https://github.com/cdatasoftware/microsoft-planner-mcp-server-by-cdata.git
cd microsoft-planner-mcp-server-by-cdata
mvn clean installDownload and install the CData JDBC Driver for Microsoft Planner from https://www.cdata.com/drivers/msplanner/download/jdbc
License the driver: from the driver install's lib folder run java -jar cdata.jdbc.msplanner.jar --license, then enter your name, email, and "TRIAL" (or your license key)
Build the connection string: run java -jar cdata.jdbc.msplanner.jar to open the Connection String utility, click "Test Connection" (browser OAuth if the source needs it), and copy the connection string
Create microsoft-planner.prp with:
Prefix=msplanner
ServerName=CDataMSPlanner
ServerVersion=1.0
DriverPath=<YOUR_DRIVER_PATH>
DriverClass=cdata.jdbc.msplanner.MSPlannerDriver
JdbcUrl=<YOUR_JDBC_URL>
Tables=Tables only picks which tables also get a ready-made description for your assistant, and empty means none; the server can still list and query every table your connection string reaches, so to keep data out of reach, limit that connection or the account it signs in with.
Add the mcpServers entry (block below) to claude_desktop_config.json, then fully quit and re-open the client
MCP Clients
Claude Desktop — macOS, Linux
{
"mcpServers": {
"microsoft-planner": {
"command": "<YOUR_PATH_TO_JAVA>",
"args": [
"-jar",
"<YOUR_PATH_TO_CDATA_MCP_JAR_WITH>",
"<YOUR_PATH_TO_MICROSOFT_PLANNER>"
]
}
}
}