NestDaddy

Matricula Church Books

io.github.ianderso/matricula-mcp · v0.1.0

Find parishes and registers on Matricula, the church-book portal; open any page in its viewer.

Connect Runs on your machine

Terminal
claude mcp add matricula-mcp -e MATRICULA_CACHE_DIR=<MATRICULA_CACHE_DIR> -e MATRICULA_TIMEOUT=<MATRICULA_TIMEOUT> -e MATRICULA_MIN_INTERVAL=<MATRICULA_MIN_INTERVAL> -e MATRICULA_SEARCH_INTERVAL=<MATRICULA_SEARCH_INTERVAL> -e MATRICULA_CONTACT=<MATRICULA_CONTACT> -e MATRICULA_DOWNLOAD_DIR=<MATRICULA_DOWNLOAD_DIR> -e MATRICULA_IMAGE_ACCESS=<MATRICULA_IMAGE_ACCESS> -- uvx matricula-mcp==0.1.0
claude_desktop_config.json
{
  "mcpServers": {
    "matricula-mcp": {
      "command": "uvx",
      "args": [
        "matricula-mcp==0.1.0"
      ],
      "env": {
        "MATRICULA_CACHE_DIR": "<MATRICULA_CACHE_DIR>",
        "MATRICULA_TIMEOUT": "<MATRICULA_TIMEOUT>",
        "MATRICULA_MIN_INTERVAL": "<MATRICULA_MIN_INTERVAL>",
        "MATRICULA_SEARCH_INTERVAL": "<MATRICULA_SEARCH_INTERVAL>",
        "MATRICULA_CONTACT": "<MATRICULA_CONTACT>",
        "MATRICULA_DOWNLOAD_DIR": "<MATRICULA_DOWNLOAD_DIR>",
        "MATRICULA_IMAGE_ACCESS": "<MATRICULA_IMAGE_ACCESS>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "matricula-mcp": {
      "command": "uvx",
      "args": [
        "matricula-mcp==0.1.0"
      ],
      "env": {
        "MATRICULA_CACHE_DIR": "<MATRICULA_CACHE_DIR>",
        "MATRICULA_TIMEOUT": "<MATRICULA_TIMEOUT>",
        "MATRICULA_MIN_INTERVAL": "<MATRICULA_MIN_INTERVAL>",
        "MATRICULA_SEARCH_INTERVAL": "<MATRICULA_SEARCH_INTERVAL>",
        "MATRICULA_CONTACT": "<MATRICULA_CONTACT>",
        "MATRICULA_DOWNLOAD_DIR": "<MATRICULA_DOWNLOAD_DIR>",
        "MATRICULA_IMAGE_ACCESS": "<MATRICULA_IMAGE_ACCESS>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "matricula-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "matricula-mcp==0.1.0"
      ],
      "env": {
        "MATRICULA_CACHE_DIR": "<MATRICULA_CACHE_DIR>",
        "MATRICULA_TIMEOUT": "<MATRICULA_TIMEOUT>",
        "MATRICULA_MIN_INTERVAL": "<MATRICULA_MIN_INTERVAL>",
        "MATRICULA_SEARCH_INTERVAL": "<MATRICULA_SEARCH_INTERVAL>",
        "MATRICULA_CONTACT": "<MATRICULA_CONTACT>",
        "MATRICULA_DOWNLOAD_DIR": "<MATRICULA_DOWNLOAD_DIR>",
        "MATRICULA_IMAGE_ACCESS": "<MATRICULA_IMAGE_ACCESS>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
MATRICULA_CACHE_DIR
Optional
Directory for the on-disk response cache.
MATRICULA_TIMEOUT
Optional
HTTP timeout in seconds for one request. Image downloads get 120 s to read.
MATRICULA_MIN_INTERVAL
Optional
Least seconds between two requests to Matricula. Never below 2.
MATRICULA_SEARCH_INTERVAL
Optional
Least seconds between two place searches. Never below 10.
MATRICULA_CONTACT
Optional
An email address or URL appended to the User-Agent, so ICARUS can reach whoever runs the server.
MATRICULA_DOWNLOAD_DIR
Optional
An existing folder. When set, matricula_page_image saves only inside it; needed to save under ~/Library, such as an iCloud Drive folder.
MATRICULA_IMAGE_ACCESS
Optional
Leave unset: page images are not fetched. Set to 'granted' only once ICARUS has granted this client access to its image host; needs MATRICULA_CONTACT.

Details

Package[email protected] (PYPI, stdio)
First published11 Oct 2026
Last updated11 Oct 2026
Registry nameio.github.ianderso/matricula-mcp

More other servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.