Skip to content

About

Padlet's hosted MCP server: connect GitHub Copilot and other AI agents to your Padlet boards

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

Padlet

Padlet MCP Server

Work with your Padlet boards from GitHub Copilot and any other AI agent that speaks the Model Context Protocol (MCP).

Padlet is a visual board for collecting and sharing ideas, used by teachers, students and teams. A board (a "padlet") holds posts with text, links, images, video and files, grouped into sections. This server lets an agent find, read, create and edit your padlets for you, in plain language.

  • Hosted by Padlet. Nothing to install or run. The server is at https://mcp.padlet.com/ (streamable HTTP).
  • No API key. You sign in with your own Padlet account in the browser the first time your client connects (OAuth).
  • Acts as you. The agent can see and change only what you can see and change in Padlet.

This repository holds documentation only. The server itself is run by Padlet; its source code is not published here.

Contents

Set up in VS Code with GitHub Copilot

One click:

Install in VS Code Install in VS Code Insiders

By hand: run MCP: Open User Configuration from the Command Palette (or create .vscode/mcp.json to share the setup with everyone working in a repository) and add:

{
  "servers": {
    "padlet": {
      "type": "http",
      "url": "https://mcp.padlet.com/"
    }
  }
}

Or from a terminal:

code --add-mcp '{"name":"padlet","type":"http","url":"https://mcp.padlet.com/"}'

Then open Copilot Chat in Agent mode. When the server starts, VS Code asks you to sign in to Padlet; see Signing in.

Copilot cloud agent (coding agent)

Not supported at the moment. GitHub's documentation says the Copilot cloud agent and Copilot code review "do not currently support remote MCP servers that leverage OAuth for authentication and authorization". Padlet's server signs you in with OAuth only and has no API-key option, so it can't be added there. Use Copilot Chat in VS Code instead.

Any other MCP client

Any client that supports remote MCP servers over streamable HTTP with OAuth can connect. Most clients take a config like this:

{
  "mcpServers": {
    "padlet": {
      "type": "http",
      "url": "https://mcp.padlet.com/"
    }
  }
}

The field names vary a little between clients (servers or mcpServers, http or streamable-http), so check your client's documentation. The URL is always https://mcp.padlet.com/.

Signing in

  1. The first time your client connects, it registers itself with Padlet and opens a Padlet sign-in page in your browser.
  2. Sign in with your Padlet account if you aren't already, and approve the request.
  3. Go back to your client. You're connected.

Your client keeps the sign-in, so you won't be asked again each time. Every tool call runs as the signed-in user and follows Padlet's normal permissions: the agent can open the padlets you can open and change the ones you can change, nothing more.

What you can ask for

For teaching and classroom work:

  • "Make a padlet called Persuasive Writing: Week 3 with sections for Ideas, Drafts and Feedback."
  • "Read my Exit Tickets padlet and summarise what students found hardest."
  • "Comment on each post in the Drafts section with one strength and one next step."
  • "Freeze my Unit 2 Reflections padlet so no one can post any more."

For teams and projects:

  • "Find my board about the Q3 retro and group the posts by theme."
  • "Add each item in TODO.md as a post on my Sprint Planning board."
  • "Export the Design Feedback padlet as a PDF."
  • "Change the Launch Plan padlet to a timeline layout with a dark wallpaper."

The agent replies with links to the padlets it worked on, so you can open them in Padlet.

Tools

With the plain URL https://mcp.padlet.com/ you get these 21 tools, whatever your library role:

Tools What they do
find_padlets, get_padlet, create_padlet Find your padlets, read one, and create a new one
update_padlet_heading, update_padlet_appearance, update_padlet_layout, update_padlet_engagement, update_padlet_post_fields, update_padlet_sharing Change a padlet's title, description and icon, its look, its layout, comments and reactions, what a post asks for, and who can open it
save_posts, save_sections, save_comments, delete_padlet_items Add and edit posts, sections and comments, and delete them
start_attachment_upload, complete_attachment_upload, analyze_post_attachments Attach a file from your computer, and read the files on posts
search_padlet_actions, describe_padlet_action, run_padlet_read_action, run_padlet_write_action, run_padlet_destructive_action Find and run every other Padlet action your account may use

The last five reach the rest of Padlet: padlet settings and moderation, collaborators, submission forms, breakout links, freezing, remaking, transferring, exporting, restoring deleted posts, whiteboard tools, automations, grading and grade sync to your LMS, Arcade activities, pinning and connecting posts, your account and the current time. If you are an owner, admin or teacher in a Padlet for Schools or Teams library, they also reach library administration.

The tool names in the toolsets below still work on the plain URL, so a client that saved them keeps working.

Toolsets

To load named tools instead, add ?toolsets= with a comma-separated list. Some clients limit how many tools a model can see across all connected servers, so you can also load only part of Padlet:

https://mcp.padlet.com/?toolsets=core
https://mcp.padlet.com/?toolsets=core,board_admin
Toolset Tools What it covers
core 17 + 2 Find, read and export padlets; create padlets; create, edit, pin, connect and restore posts; edit sections; add and delete comments; analyse attachments. Also brings the 2 file-upload tools for attaching a file from your computer.
utility 1 Current date and time (get_time)
board_admin 30 Per-padlet settings: appearance, layout, wallpaper, post fields and sorting, access and collaborators, submission forms, breakout links, freezing, remaking, transferring to another of your workspaces, automations, Arcade activities, grading and grade sync to your LMS, whiteboard tools
library 24 Padlet for Schools and Teams library admin: invites and invite links, onboarding, Google/Microsoft sign-in and SAML SSO, approved domains, permissions, content safety, allowed attachment types

?toolsets=core,utility,board_admin,library gives 50 tools, or 74 if you are an owner, admin or teacher in a Padlet for Schools or Teams library. The library toolset appears only for those accounts. ?toolsets=core gives 19 tools (the 17 core tools plus the 2 upload tools). Unknown toolset names are ignored.

For a strictly read-only connection, use https://mcp.padlet.com/read-only. It serves 5 tools that only find and read padlets (get_current_user_info, list_padlets, search_walls, get_padlet_content, export_padlet) and can't create or change anything.

All tool names by toolset

core: get_current_user_info, list_padlets, search_walls, get_padlet_content, export_padlet, create_padlet, update_padlet_title_description, create_posts, update_posts, update_section, pin_post, create_post_connection, delete_post_connection, restore_posts_and_sections, add_comment_to_post, delete_comment, analyze_post_attachments. Upload tools served with core: start_attachment_upload, complete_attachment_upload.

utility: get_time

board_admin: update_padlet_icon, update_padlet_appearance, update_padlet_layout, update_padlet_wallpaper, update_padlet_map_style, get_padlet_post_properties, update_padlet_post_properties, update_padlet_post_sort, update_padlet_settings, get_padlet_content_settings, update_padlet_content_settings, get_padlet_access_settings, update_padlet_access_settings, invite_email_as_padlet_collaborator, update_delete_padlet_collaborator_user, update_submission_form_settings, update_breakout_settings, delete_custom_fields, freeze_padlet, create_automation, delete_automations, get_padlet_automations, remake_padlet, transfer_padlet, update_auto_remake_settings, create_padlet_arcade_activity, grade_posts, sync_grades_to_lms, get_whiteboard_tool_settings, update_whiteboard_tool_settings

library: list_libraries, get_library_info, get_library_invite_links, update_library_invite_links, send_library_email_invites, remove_library_email_invites, bulk_invite_library_members, get_library_onboarding_flow, complete_library_onboarding_step, get_library_oauth_settings, update_library_oauth_settings, get_library_saml_settings, create_library_saml_connection, update_library_saml_connection, validate_saml_metadata_url, get_library_approved_domains, request_library_domain_approval, remove_library_approved_domains, get_library_permissions, update_library_permission, get_library_content_safety, update_library_content_safety, get_library_attachment_type_settings, update_library_attachment_type

ChatGPT

Padlet's app in ChatGPT connects to this same server, but lists one tool for each operation. It has no action tools. It lists the first 16 tools above, plus each toolset tool that does a job none of them covers, such as freeze_padlet, remake_padlet and the library tools. A new Padlet tool appears in ChatGPT after OpenAI approves it.

Limits and safety

  • Everything runs as you. There is no shared service account. Library tools still check your role in that library on every call.
  • Changes you can undo, and changes you can't. Deleted posts and sections can be restored with restore_posts_and_sections. A tool is marked destructive when it overwrites what a person wrote, deletes something, or changes a whole library in a way that can't be put back exactly. Clients that honour MCP tool annotations can ask you before running those tools. On the plain URL they are update_padlet_heading, update_padlet_sharing, save_posts, save_sections, save_comments, delete_padlet_items, complete_attachment_upload and run_padlet_destructive_action, which runs every destructive action.
  • Sandbox (whiteboard) padlets are only partly supported; the other padlet formats are fully supported.

Support, privacy and terms

License

MIT, see LICENSE. This repository contains documentation only; the MCP server is hosted by Padlet at https://mcp.padlet.com/.

Padlet and the Padlet logo are trademarks of Wallwisher, Inc. The MIT license covers the text in this repository; it does not grant any right to use Padlet's name or marks.

About

Padlet's hosted MCP server: connect GitHub Copilot and other AI agents to your Padlet boards

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors