Skip to main content
Glama
Mpercy-Git

tapestry-mcp

by Mpercy-Git
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

tapestry-mcp

Unofficial, read-only MCP server for the Tapestry learning journal (tapestryjournal.com, Android com.fsf.tapestry), for parents and carers.

Tapestry has no public API. This logs in with your own email and password and calls the same internal /api/4/… endpoints the web app uses (found via tapestry-scraper). It may break if Tapestry changes their web app. Accounts using 2FA or SSO-only login aren't supported.

Tools

Tool

What it does

list_children

Children on the account (ids for filtering)

list_observations

Newest-first summaries; child_id, since/until (YYYY-MM-DD), limit

get_observation

Full notes (HTML stripped), tags/EYFS links, comments, media URLs; include_raw for the raw JSON

search_observations

Keyword search over titles, notes and tags

download_media

Saves an observation's photos/videos to TAPESTRY_DOWNLOAD_DIR/<date>_<id>/

Related MCP server: librus-mcp

Add to Frona

Settings → MCP → Custom → Local package

Field

Value

Runtime

npm

Package identifier

github:Mpercy-Git/tapestry-mcp (pin with github:Mpercy-Git/tapestry-mcp#v0.2.0)

Transport

stdio

Env

TAPESTRY_EMAIL, TAPESTRY_PASSWORD (bind the password to a vault credential if you prefer), optional TAPESTRY_DOWNLOAD_DIR

Other MCP clients

{
  "mcpServers": {
    "tapestry": {
      "command": "npx",
      "args": ["-y", "github:Mpercy-Git/tapestry-mcp"],
      "env": { "TAPESTRY_EMAIL": "you@example.com", "TAPESTRY_PASSWORD": "…" }
    }
  }
}

Notes

  • Session cookies are only sent to tapestryjournal.com; media on other hosts (CDN) is fetched without them.

  • If a field comes back empty, call get_observation with include_raw: true and adjust the mapping in src/server.js.

Dev

npm install && npm test

Requires Node 20+. No build step — plain ES modules, so installing straight from GitHub works.

Releasing

Bump version in package.json and in server.json (top-level and under packages), then merge to main. The Release workflow runs the tests, tags v<version> and publishes a GitHub release with the npm pack tarball attached. Pushes that don't change the version are a no-op; it can also be run by hand from the Actions tab.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • vklass-mcp

    perapp
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables guardians to securely query read-only Vklass data such as children, news, calendar entries, assignments, grades, meals, and notifications through MCP, with per-user BankID and OAuth 2.1 authentication.
    MIT

  • librus-mcp

    TechAdrianPro
    F
    license
    A
    quality
    C
    maintenance
    Enables read-only access to a Librus Portal account, letting users list linked Synergia accounts and retrieve grades, attendance, timetable, homework, notices, and school information.
    3
    -