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: MCP Notes Server

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

Install Server
F
license - not found
A
quality
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.

Tools

Related MCP Servers

  • MCP Notes Server

    pipinho13
    A
    license
    -
    quality
    B
    maintenance
    A beginner-friendly MCP server for managing personal notes. Enables Claude to create, list, read, search, update, and delete notes saved as Markdown files.
    Last updated
    MIT

  • Notes MCP Server

    vermavarun
    F
    license
    -
    quality
    C
    maintenance
    A learning-oriented MCP server for managing notes, providing tools to create, list, get, update, delete, and search notes, along with resources and prompt templates.
    Last updated
    14

View all related MCP servers

Related MCP Connectors

  • better-notion-mcp

    Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.

  • mcp

    Augments MCP Server - A comprehensive framework documentation provider for Claude Code

  • notesbridge

    Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.

View all MCP Connectors

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