feat(messaging): add inbox, conversation, search, and send tools by 5queezer · Pull Request #235 · stickerdaniel/linkedin-mcp-server

5queezer · 2026-03-19T22:17:27Z

Summary

Adds 4 new messaging tools to the LinkedIn MCP server (#234):

get_inbox — list recent conversations from messaging inbox
get_conversation — read a specific thread by username or thread_id
search_conversations — search messages by keyword
send_message — send a message to a LinkedIn user

Checklist

Code

Add extractor methods to LinkedInExtractor (scraping/extractor.py)
Add messaging.py tool registration (tools/messaging.py)
Register tools in create_mcp_server() (server.py)
Add "messaging" reference kind (scraping/link_metadata.py)

Tests

Add mock methods to _make_mock_extractor (tests/test_tools.py)
Add TestMessagingTools class (tests/test_tools.py)
Add TestMessaging class (tests/test_scraping.py)
Add messaging URL classification tests (tests/test_link_metadata.py)
Update TestToolTimeouts.tool_names tuple

Docs

Update tool table in README.md
Update features list in docs/docker-hub.md
Add tools to manifest.json

Verify

uv run pytest --cov — 297 passed, 74.32% coverage
uv run ruff check . && uv run ruff format .
uv run ty check
uv run pre-commit run --all-files
Live test get_inbox
Live test get_conversation
Live test search_conversations
Live test send_message

Test plan

Start server: uv run -m linkedin_mcp_server --transport streamable-http --log-level DEBUG
Verify get_inbox returns conversation list
Verify get_conversation with a known username returns messages
Verify search_conversations returns filtered results
Verify send_message sends to a test account (⚠️ destructive — first write tool)

Notes

send_message is the first write operation in the server. It uses readOnlyHint: false and openWorldHint: true to signal MCP clients to confirm before sending.
Messaging tools don't follow the section-config pattern in fields.py — each method navigates directly.
LinkedIn may restrict messaging to 1st-degree connections. The tool handles "Message" button absence with a clear error.

Generated with Claude Opus 4.6. Prompt: Implement the following plan: LinkedIn Messaging Tools

🤖 Generated with Claude Code

- Add weekly schedule (Monday 6am) - Group all GitHub Actions and Docker images as 'CI dependencies' - Group all major updates together - Remove automerge (insufficient test coverage)

- Change package name to linkedin-scraper-mcp for PyPI availability - Add PyPI metadata (authors, license, keywords, classifiers, URLs) - Add id-token permission and publish steps to release workflow - Update README with new uvx install commands and PyPI badge - Update AGENTS.md with uvx command - Create py.typed marker for type checker support Users can now install with: uvx linkedin-scraper-mcp

…kerdaniel#133) - Change package name to linkedin-scraper-mcp for PyPI availability - Add PyPI metadata (authors, license, keywords, classifiers, URLs) - Add id-token permission and publish steps to release workflow - Update README with new uvx install commands and PyPI badge - Update AGENTS.md with uvx command - Create py.typed marker for type checker support Users can now install with: uvx linkedin-scraper-mcp

…ependencies chore(deps): update ci dependencies

Point dependency at stickerdaniel/linkedin_scraper fork (fix/rate-limit-false-positive) to fix detect_rate_limit() false-firing on React RSC payloads. Also update docs with detailed release workflow notes and bump opencode agent models to gpt-5.3-codex. See also: joeyism/linkedin_scraper#278

…el#139) Point dependency at stickerdaniel/linkedin_scraper fork (fix/rate-limit-false-positive) to fix detect_rate_limit() false-firing on React RSC payloads. Also update docs with detailed release workflow notes and bump opencode agent models to gpt-5.3-codex. See also: joeyism/linkedin_scraper#278

…daniel#140)

Replace Playwright with Patchright (anti-detection fork) and use launch_persistent_context(user_data_dir=...) for full Chromium profile persistence. This fixes cross-platform session issues where sessions created on macOS failed in Docker (Linux, headless). BREAKING CHANGE: Old session.json files and LINKEDIN_COOKIE env var are no longer supported. Users must re-run --get-session to create a new persistent browser profile at ~/.linkedin-mcp/profile/.

…aniel#143) feat!: Switch to patchright with persistent browser context Replace Playwright with Patchright (anti-detection fork) and use launch_persistent_context(user_data_dir=...) for full Chromium profile persistence. This fixes cross-platform session issues where sessions created on macOS failed in Docker (Linux, headless). BREAKING CHANGE: Old session.json files and LINKEDIN_COOKIE env var are no longer supported. Users must re-run --get-session to create a new persistent browser profile at ~/.linkedin-mcp/profile/. polish the implementation

…ocker-bridge-debug Feature/220 docker bridge debug

Search results pages load a placeholder first, then fill in the actual results via JavaScript. The extractor reads innerText before content loads, causing search_people to return empty sections intermittently. Add wait_for_function for /search/results/ URLs (same pattern as the activity feed fix in stickerdaniel#203). Wait up to 10s for main.innerText > 100 chars before extracting. Tested locally: 100% success rate vs ~60% before the fix. Made-with: Cursor

…ts-content-wait fix(scraping): wait for search results content before extracting

…im_agents.md_to_behavioral_guidance_clean_readme_docker_section docs: Trim AGENTS.md to behavioral guidance, clean README Docker section

This PR contains the following updates: | Package | Type | Update | Change | |---|---|---|---| | [anthropics/claude-code-action](https://redirect.github.com/anthropics/claude-code-action) ([changelog](https://redirect.github.com/anthropics/claude-code-action/compare/26ec041249acb0a944c0a47b6c0c13f05dbc5b44..df37d2f0760a4b5683a6e617c9325bc1a36443f6)) | action | digest | `26ec041` → `df37d2f` | | [astral-sh/setup-uv](https://redirect.github.com/astral-sh/setup-uv) ([changelog](https://redirect.github.com/astral-sh/setup-uv/compare/5a095e7a2014a4212f075830d4f7277575a9d098..37802adc94f370d6bfd71619e3f0bf239e1f3b78)) | action | digest | `5a095e7` → `37802ad` | | ghcr.io/astral-sh/uv | final | digest | `10902f5` → `3472e43` | | [oven-sh/setup-bun](https://redirect.github.com/oven-sh/setup-bun) ([changelog](https://redirect.github.com/oven-sh/setup-bun/compare/ecf28ddc73e819eb6fa29df6b34ef8921c743461..0c5077e51419868618aeaa5fe8019c62421857d6)) | action | digest | `ecf28dd` → `0c5077e` | | python | stage | digest | `5404df0` → `55e465c` | | [softprops/action-gh-release](https://redirect.github.com/softprops/action-gh-release) ([changelog](https://redirect.github.com/softprops/action-gh-release/compare/a06a81a03ee405af7f2048a818ed3f03bbf83c7b..153bb8e04406b158c6c84fc1615b65b24149a1fe)) | action | digest | `a06a81a` → `153bb8e` | --- ### Configuration 📅 **Schedule**: Branch creation - "before 6am on Monday" (UTC), Automerge - At any time (no schedule defined). 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever PR is behind base branch, or you tick the rebase/retry checkbox. 👻 **Immortal**: This PR will be recreated if closed unmerged. Get [config help](https://redirect.github.com/renovatebot/renovate/discussions) if that's undesired. --- - [ ] If you want to rebase/retry this PR, check this box --- This PR was generated by [Mend Renovate](https://mend.io/renovate/). View the [repository job log](https://developer.mend.io/github/stickerdaniel/linkedin-mcp-server).

Closes stickerdaniel#234 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

github-actions Bot and others added 30 commits January 27, 2026 11:52

chore: update manifest.json and docker-compose.yml to v2.3.2 [skip ci]

a184788

chore(renovate): reduce PR noise with aggressive grouping

7188157

- Add weekly schedule (Monday 6am) - Group all GitHub Actions and Docker images as 'CI dependencies' - Group all major updates together - Remove automerge (insufficient test coverage)

chore: bump version to 2.3.3

1980ac0

chore: update manifest.json and docker-compose.yml to v2.3.3 [skip ci]

cce68f1

fix: regenerate uv.lock for new package name

d707115

chore: bump version to 2.3.4

f2f58dc

chore: update manifest.json and docker-compose.yml to v2.3.4 [skip ci]

caca786

fix: add linkedin-scraper-mcp CLI alias for cleaner uvx usage

67fe1cf

chore: bump version to 2.3.5

59de989

chore: update manifest.json and docker-compose.yml to v2.3.5 [skip ci]

a3daff5

chore(deps): update ci dependencies

7ae5b94

Merge pull request stickerdaniel#134 from stickerdaniel/renovate/ci-d…

78c5d17

…ependencies chore(deps): update ci dependencies

chore(deps): update ci dependencies

96b932d

Merge pull request stickerdaniel#138 from stickerdaniel/renovate/ci-d…

6a00243

…ependencies chore(deps): update ci dependencies

chore: update manifest.json and docker-compose.yml to v2.3.6 [skip ci]

3a29591

fix(docker): install git for git-based dependency resolution

f1331c7

fix(docker): install git for git-based dependency resolution (sticker…

c1bfaf4

…daniel#140)

chore: bump version to 2.3.7

d9decd0

chore: bump version to 2.3.7 (stickerdaniel#141)

76ea004

chore: update manifest.json and docker-compose.yml to v2.3.7 [skip ci]

4a8c1ee

polish the implementation

48d9547

chore: bump version to 3.0.0

03f0e44

chore: bump version to 3.0.0 (stickerdaniel#144)

fd0f524

chore: update manifest.json and docker-compose.yml to v3.0.0 [skip ci]

e6a5540

stickerdaniel and others added 25 commits March 13, 2026 09:14

fix(bridge): honor debug cookie override

aa86a1b

refactor(debug): drop private cookie helper

b8885bb

fix(browser): close startup failures

1d2f6dd

fix(setup): align portable cookie export

f6e153a

fix(bridge): rebridge stale derived profile

a0b66c5

refactor(auth): harden session metadata

0c72ead

fix(diagnostics): skip missing gist files

842f609

Merge pull request stickerdaniel#221 from stickerdaniel/feature/220-d…

dc075a1

…ocker-bridge-debug Feature/220 docker bridge debug

chore: Bump version to 4.4.0

9d306d2

chore: Bump version to 4.4.0 (stickerdaniel#222)

c58a3ce

chore: update manifest.json and docker-compose.yml to v4.4.0 [skip ci]

7c15646

Merge pull request stickerdaniel#225 from jonzarecki/fix/search-resul…

1457d66

…ts-content-wait fix(scraping): wait for search results content before extracting

chore: Bump version to 4.4.1

6a2b0d2

chore: Bump version to 4.4.1 (stickerdaniel#228)

31e8809

chore: update manifest.json and docker-compose.yml to v4.4.1 [skip ci]

922b2ad

docs: Trim AGENTS.md to behavioral guidance, clean README Docker section

bc8fc78

docs(agents): Add commit message format

2dbe6f0

docs: Add brief Docker auth bridging explanation

ed51f92

docs: Mention uvx as stable alternative to Docker

78cc570

docs: Fix stale AGENTS.md tool table reference in CONTRIBUTING.md

7dc48bf

Merge pull request stickerdaniel#229 from stickerdaniel/03-16-docs_tr…

1a4e8fd

…im_agents.md_to_behavioral_guidance_clean_readme_docker_section docs: Trim AGENTS.md to behavioral guidance, clean README Docker section

chore(deps): update ci dependencies

f02830d

feat(messaging): add inbox, conversation, search, and send tools

522bd46

Closes stickerdaniel#234 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

5queezer mentioned this pull request Mar 19, 2026

feat(messaging): add inbox, conversation, search, and send tools 5queezer/linkedin-mcp-server#6

Merged

25 tasks

ramonmazinga mentioned this pull request Mar 31, 2026

feat(messaging): add inbox, conversation, search, and send tools #298

Closed

5 tasks

stickerdaniel force-pushed the main branch 2 times, most recently from fd80f60 to 7661f43 Compare April 3, 2026 07:59

stickerdaniel force-pushed the main branch from 333ac28 to cd6513f Compare April 17, 2026 09:36

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(messaging): add inbox, conversation, search, and send tools#235

feat(messaging): add inbox, conversation, search, and send tools#235
5queezer wants to merge 654 commits into
stickerdaniel:mainfrom
5queezer:feature/234-messaging-tools

5queezer commented Mar 19, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

5queezer commented Mar 19, 2026

Summary

Checklist

Code

Tests

Docs

Verify

Test plan

Notes

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants