Skip to main content
Glama
TejGandham

parchmark-mcp

by TejGandham
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

parchmark-mcp

MCP server for managing ParchMark notes via Claude Code/Desktop.

Installation

# Run directly
uvx --from git+https://github.com/TejGandham/parchmark-mcp parchmark-mcp

# Or install
pip install git+https://github.com/TejGandham/parchmark-mcp

Related MCP server: Local Knowledge Desk

Upgrading

Caveat: the uvx --from git+… install above is unpinned, but uvx caches the resolved git commit and reuses it — it does not re-pull new commits on its own. New releases will not appear until you bust the cache:

# Re-fetch the default-branch HEAD and rebuild the cached environment
uvx --refresh --from git+https://github.com/TejGandham/parchmark-mcp parchmark-mcp
# …or just clear this package's cache so the next launch re-resolves
uv cache clean parchmark-mcp

Then restart your MCP client (Claude Code/Desktop, opencode) so it relaunches the server — a running client keeps the old process until restarted. See docs/INSTALL.md for details and the pip/uv pip equivalents.

Configuration

Environment Variables

Variable

Description

Example

PARCHMARK_URL

API base URL

https://parchmark.example.com/api

PARCHMARK_USERNAME

Your username

myuser

PARCHMARK_PASSWORD

Your password

mypassword

Claude Code Setup

claude mcp add parchmark -s user \
  -e "PARCHMARK_URL=https://your-instance/api" \
  -e "PARCHMARK_USERNAME=your-user" \
  -e "PARCHMARK_PASSWORD=your-pass" \
  -- uvx --from git+https://github.com/TejGandham/parchmark-mcp parchmark-mcp

Or manually add to .mcp.json:

{
  "mcpServers": {
    "parchmark": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/TejGandham/parchmark-mcp", "parchmark-mcp"],
      "env": {
        "PARCHMARK_URL": "https://parchmark.example.com/api",
        "PARCHMARK_USERNAME": "your-username",
        "PARCHMARK_PASSWORD": "your-password"
      }
    }
  }
}

Tools

Tool

Parameters

Description

list_notes

None

List all notes (metadata only)

get_note

note_id

Get a specific note with full content

create_note

content

Create a new note from markdown

update_note

note_id, content

Update an existing note

delete_note

note_id

Delete a note

Architecture

parchmark-mcp/
├── src/parchmark_mcp/
│   ├── __init__.py      # Package version
│   ├── server.py        # FastMCP server & tools
│   ├── client.py        # ParchMark API client
│   └── models.py        # Pydantic models
├── tests/
│   ├── test_models.py   # Model tests
│   ├── test_client.py   # Client tests (mocked)
│   └── test_server.py   # Server tests (mocked)
└── pyproject.toml       # Package config

Development

# Clone and install
git clone https://github.com/TejGandham/parchmark-mcp
cd parchmark-mcp
uv sync --all-extras

# Run tests
uv run pytest tests/ -v

# Lint & format
uv run ruff check src/ tests/
uv run ruff format src/ tests/

# Type check
uv run pyright src/ tests/

Quality Gates

Pre-commit hooks enforce:

  • ruff - Linting with autofix

  • ruff-format - Code formatting

  • pyright --strict - Type checking

Tech Stack

  • FastMCP - Python MCP framework

  • httpx - Async HTTP client

  • Pydantic - Data validation & models

  • pyright - Static type checking (strict mode)

  • ruff - Linting & formatting

  • pytest - Testing with async support

License

MIT

This server cannot be installed

F
license - not found
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/TejGandham/parchmark-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server