Claude-SharepointLists

A Claude Code skill for connecting to Microsoft SharePoint Lists via the Microsoft Graph API, with full read/write (CRUD) over list items using app-only (client-credentials) authentication.

What's here

.claude/skills/sharepoint-lists/
├── SKILL.md                 # how the skill works + usage
├── .env.example             # credential template (copy to .env; .env is git-ignored)
├── scripts/
│   ├── sp.mjs               # CLI: test | lists | columns | items | get | create | update | delete
│   └── lib/graph.mjs        # reusable, dependency-free Graph client (SharePointListsClient)
└── references/
    ├── setup.md             # Azure AD (Entra) app registration walkthrough
    └── graph-api.md         # field-type formats + OData query reference

Quick start

1. Create an Entra app registration and grant it a SharePoint Graph permission (Sites.Selected preferred). See references/setup.md.

2. Copy .env.example to .env and fill in SP_TENANT_ID, SP_CLIENT_ID, SP_CLIENT_SECRET (optionally SP_SITE_URL).

3. Verify connectivity:

   cd .claude/skills/sharepoint-lists/scripts
   node sp.mjs test --site "https://<tenant>.sharepoint.com/sites/<SiteName>"
   

Security

Credentials live only in .env, which is git-ignored — never commit secrets. The Graph + auth logic is isolated in scripts/lib/graph.mjs so it can later be wrapped as a standalone MCP server without a rewrite.